Display a live trust badge for any agent on your website, README, or documentation. Badges are rendered as SVG images that update automatically.
https://veriswarm.ai/v1/badge/{agent-slug}.svg
Replace {agent-slug} with the agent's slug (the URL-safe identifier shown on the agent's profile page).
Two badge styles are available, controlled by the style query parameter:
A single-line pill showing the tier label, composite trust score, and verification status.
https://veriswarm.ai/v1/badge/my-agent.svg?style=compact
Renders approximately 220px wide and 28px tall.
A detailed card showing all four dimension scores with bar charts.
https://veriswarm.ai/v1/badge/my-agent.svg?style=card
Renders 256px wide and 160px tall. Shows Identity, Risk, Reliability, and Autonomy scores with color-coded bars.
Control the color scheme with the theme query parameter:
| Parameter | Background | Best For |
|---|---|---|
theme=dark (default) |
Dark charcoal (#110f0d / #191613) | Dark backgrounds, GitHub dark mode |
theme=light |
Warm cream (#f5f0e8) | Light backgrounds, documentation sites |
Examples:
https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&theme=dark
https://veriswarm.ai/v1/badge/my-agent.svg?style=card&theme=light
<!-- Compact badge -->
<a href="https://veriswarm.ai/agents/my-agent">
<img
src="https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&theme=dark"
alt="VeriSwarm Trust Badge"
/>
</a>
<!-- Detailed card -->
<a href="https://veriswarm.ai/agents/my-agent">
<img
src="https://veriswarm.ai/v1/badge/my-agent.svg?style=card&theme=dark"
alt="VeriSwarm Trust Report"
/>
</a>
[](https://veriswarm.ai/agents/my-agent)
For GitHub's dark/light mode, use the theme=dark variant -- it works well on both modes due to the distinct background color. If you need to support both themes explicitly, use GitHub's #gh-dark-mode-only and #gh-light-mode-only fragments:
[](https://veriswarm.ai/agents/my-agent)
[](https://veriswarm.ai/agents/my-agent)
Badges are served with a Cache-Control: public, max-age=3600 header (1 hour). This means:
If you need to force a fresh badge (e.g., for testing), append a random query parameter:
https://veriswarm.ai/v1/badge/my-agent.svg?style=compact&_t=1711234567
Badge endpoints serve SVG with appropriate CORS headers, so cross-origin embedding works from any domain. No special configuration is needed on your side.
If the agent has not been scored yet (no events ingested), the badge displays a neutral "Not Yet Scored" label instead of scores. This avoids showing misleading zero-score badges for newly registered agents.
Wrap the badge image in a link to the agent's public profile page:
https://veriswarm.ai/agents/{agent-slug}
This gives viewers a way to inspect the full trust report, score history, and verification status.
If you have configured a custom domain for your workspace, badges can also be served from your domain once DNS verification is complete. The badge URL format remains the same with your domain substituted.