---
title: "Get version-pinned agent verification badge SVG"
method: GET
path: "/api/registry/agents/{encodedUrl}/badge/{role}/{version}.svg"
tags: ["Agent Compliance"]
---

# Get version-pinned agent verification badge SVG

`GET /api/registry/agents/{encodedUrl}/badge/{role}/{version}.svg`

## Request

- Base URL: `https://agenticadvertising.org`
- URL: `https://agenticadvertising.org/api/registry/agents/{encodedUrl}/badge/{role}/{version}.svg`
- Auth: none required

Returns an SVG badge image scoped to a specific AdCP release (MAJOR.MINOR, e.g. '3.0'). Buyers who want to call out 'verified for 3.0' embed this instead of the legacy `/badge/{role}.svg` (which auto-upgrades to the highest active version). Renders 'Not Verified' when the agent never earned a badge at this version or opted out of compliance monitoring. Registry visibility does not affect verification.

## Path parameters

- `encodedUrl` string, required: URL-encoded agent URL
- `role` 'media-buy' | 'creative' | 'signals' | 'governance' | 'brand' | 'sponsored-intelligence', required: Canonical badge role
- `version` string, required: AdCP release as MAJOR.MINOR (e.g. '3.0', '3.1')

## Response `200`

SVG badge image

## Other responses

- `400`: Invalid agent URL, role, or version
- `500`: Server error
- `503`: Badge status temporarily unavailable

## Changes

- **2026-08-11** `c8c5f00c15d1`: 2 breaking, 3 info
  - the response's body type changed from `object` to no type for status `400`
  - removed the required property `error` from the response with the `400` status
  - for the `path` request parameter `role`, the type was generalized from `string` to no type
  - added `#/components/schemas/Error, subschema #1` to the response body `anyOf` list for the response status `400`
  - …1 more

[Operation history](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/changes/api/registry/agents/:encodedUrl/badge/:role/:version.svg/get.md)

---

[API](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api.md) - [All operations](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adcontextprotocol/apis/agenticadvertising-org-registry-api/revisions/d8f6af89f253?raw)