ADadcontextprotocol
Agent Compliance

Get version-pinned embeddable badge code

Changed on

Returns HTML and Markdown embed snippets that point at the version-pinned SVG. Alt text includes the version (e.g. 'AgenticAdvertising.org Verified Media Buy Agent 3.0'). Buyers who want to freeze on a specific AdCP release embed these instead of the legacy /badge/{role}/embed. Compliance opt-out returns verified: false; registry visibility does not affect verification.

get/api/registry/agents/{encodedUrl}/badge/{role}/{version}/embed

Request

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

Path parameters

encodedUrlstring required

URL-encoded agent URL

role'media-buy' | 'creative' | 'signals' | 'governance' | 'brand' | 'sponsored-intelligence' required

Canonical badge role

versionstring required

AdCP release as MAJOR.MINOR

Response

Embed code

agent_urlstring required
role'media-buy' | 'creative' | 'signals' | 'governance' | 'brand' | 'sponsored-intelligence' required
verifiedboolean required
grading_profile'legacy' | 'spec' required
adcp_versionstring required
badge_svg_urlstring required
registry_urlstring required
htmlstring required
markdownstring required

Changes

  • 9fd74b5fc890Revision changes
    • info

      added the required property to the response with the status

  • c8c5f00c15d1Revision changes
    • breaking

      the response's body type changed from object to no type for status

    • breaking

      removed the required property from the response with the status

    • warning

      added the new brand enum value to the response property for the response status

    • warning

      added the new creative enum value to the response property for the response status

    • warning

      added the new governance enum value to the response property for the response status

    • warning

      added the new media-buy enum value to the response property for the response status

    • warning

      added the new signals enum value to the response property for the response status

    • warning

      added the new sponsored-intelligence enum value to the response property for the response status

    • info

      for the path request parameter role, the type was generalized from string to no type

    • info

      added subschema #1 to the response body anyOf list for the response status

    • info

      added the non-success response with the status

    • info

      the response property became required for the status