---
title: "Changes to Get version-pinned embeddable badge code"
method: GET
path: "/api/registry/agents/{encodedUrl}/badge/{role}/{version}/embed"
---

# Changes to Get version-pinned embeddable badge code

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

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 71 revisions.

- **2026-09-16** `9fd74b5fc890`: 1 info
- **2026-08-11** `c8c5f00c15d1`: 2 breaking, 6 warning, 4 info

## Changes

- **2026-09-16** `9fd74b5fc890`: 1 info
  - added the required property `grading_profile` to the response with the `200` status
- **2026-08-11** `c8c5f00c15d1`: 2 breaking, 6 warning, 4 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
  - added the new `brand` enum value to the `role` response property for the response status `200`
  - added the new `creative` enum value to the `role` response property for the response status `200`
  - added the new `governance` enum value to the `role` response property for the response status `200`
  - added the new `media-buy` enum value to the `role` response property for the response status `200`
  - added the new `signals` enum value to the `role` response property for the response status `200`
  - added the new `sponsored-intelligence` enum value to the `role` response property for the response status `200`
  - 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`
  - added the non-success response with the status `503`
  - the response property `adcp_version` became required for the status `200`

---

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