Skip to main content
VaultGraph trust badges are SVG images served from the VaultGraph CDN. They display a live trust score that updates automatically as new receipts are verified — no JavaScript required, no maintenance overhead. There are two badge types:
  • Organization badge — aggregated trust score across all your public agents (recommended for homepages)
  • Agent badge — trust score for a specific agent (recommended for per-agent landing pages)

Organization badge

Combined score across all opted-in agents. Links to your vendor landing page at /explorer/{vendorSlug}.

Agent badge

Score for a single agent. Links to the agent profile at /explorer/{vendorSlug}/{agentSlug}.

​
Prerequisites

  1. You have a VaultGraph vendor account with at least one agent.
  2. You have submitted JobReceipts so there is a trust score to display.
  3. Public profiles must be enabled. See Public Agent Profiles.

​
Configure your badge

  1. Go to the platform portal → Settings
  2. Scroll to the Trust Badge section
  3. Choose Organization (default) or Specific Agent
  4. Select a variant — compact, standard, or detailed
  5. Select a theme — light, dark, or auto
  6. Copy the generated embed code
The preview updates live as you change settings.

​
Embed the badge

Paste the copied snippet anywhere in your HTML. The <img> tag fetches the badge SVG from VaultGraph’s servers on each page load (responses are cached for 5 minutes at the CDN edge).

​
Organization badge

<!-- VaultGraph Trust Badge -->
<a href="https://app.vaultgraph.com/explorer/{vendorSlug}" target="_blank" rel="noopener">
  <img
    src="https://app.vaultgraph.com/api/public/orgs/{vendorSlug}/badge?variant=standard&theme=light"
    alt="{Your Org Name} Trust Score - Verified by VaultGraph"
    width="240"
    height="60"
  />
</a>

​
Agent badge

<!-- VaultGraph Trust Badge -->
<a href="https://app.vaultgraph.com/explorer/{vendorSlug}/{agentSlug}" target="_blank" rel="noopener">
  <img
    src="https://app.vaultgraph.com/api/public/agents/{agentId}/badge?variant=standard&theme=light"
    alt="{Agent Name} Trust Score - Verified by VaultGraph"
    width="240"
    height="60"
  />
</a>
Replace {vendorSlug}, {agentSlug}, and {agentId} with your actual values. Your slug is visible in your portal URL (/v/{vendorSlug}/...).

​
Badge variants

VariantDimensionsContent
compact160 × 40 pxTrust score percentage + VaultGraph logo
standard240 × 60 pxName + score + “Verified by VaultGraph”
detailed300 × 100 pxName + score + 7-day sparkline + receipt count
Specify the variant with the ?variant= query parameter: 
/api/public/orgs/{slug}/badge?variant=compact
/api/public/orgs/{slug}/badge?variant=detailed

​
Themes

ThemeBackgroundUse when
lightWhiteEmbedding on light-background pages
darkDark (#1a1a2e)Embedding on dark-background pages
autoTransparentEmbedding on pages where background varies
/api/public/orgs/{slug}/badge?variant=standard&theme=dark
/api/public/orgs/{slug}/badge?variant=standard&theme=auto

​
API reference

Both badge endpoints are unauthenticated — no API key required. Responses include Cache-Control: public, s-maxage=300, stale-while-revalidate=3600 headers.
EndpointDescription
GET /api/public/orgs/{slug}/badgeOrg-level badge SVG
GET /api/public/agents/{id}/badgeAgent-level badge SVG
Both accept ?variant=compact\|standard\|detailed and ?theme=light\|dark\|auto. Returns 404 if the org or agent has not enabled public profiles. See the full API Reference for schema details.

​
Caching behavior

Badge SVGs are cached for 5 minutes (s-maxage=300) at the CDN edge, and served stale for up to 1 hour while revalidating in the background (stale-while-revalidate=3600). This means trust scores displayed in badges may lag behind the live data by up to 5 minutes.