---
title: "Changes to Read Open Badge Assertion"
method: GET
path: "/v1/badge_assertion/{badge_assertion_id}/open_badges"
---

# Changes to Read Open Badge Assertion

`GET /v1/badge_assertion/{badge_assertion_id}/open_badges`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 12 revisions.

- **2026-08-06** `4039d06e340b`: 1 breaking, 10 info
- **2025-11-20** `6eb631bcc695`: 17 breaking, 5 info

## Changes

- **2026-08-06** `4039d06e340b`: 1 breaking, 10 info
  - the `detail` response's property type changed from `array` to `string` for status `422`
  - api operation id `read_open_badge_assertion_v1_badge_assertion__badge_assertion_id__open_badges_get` removed and replaced with `badge_assertion_read_open_badge_assertion`
  - added the new optional `header` request parameter `X-Access-Token`
  - added the new optional `query` request parameter `format`
  - added the new optional `query` request parameter `version`
  - added the non-success response with the status `410`
  - added the optional property `badge/alignment/anyOf[subschema #1]/items/targetCode` to the response with the `200` status
  - the `detail` response's property default value `Unprocessable data` was added for the status `422`
  - the `detail` response's property default value changed from `Unauthorized access` to `Insufficient permissions` for the status `403`
  - the `type` response's property default value changed from `HostedBadge` to `hosted` for the status `200`
  - added the required property `verification/url` to the response with the `200` status
- **2025-11-20** `6eb631bcc695`: 17 breaking, 5 info
  - the response property `badge/description` became optional for the status `200`
  - the response property `badge/id` became optional for the status `200`
  - the response property `badge/name` became optional for the status `200`
  - response property `badge/alignment` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `badge/issuer/description` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `badge/issuer/image` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `badge/tags` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `evidence` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `expires` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `narrative` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `recipient/salt` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `revocationReason` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - the `badge/criteria` response's property type changed from `object` to no type for status `200`
  - the `image` response's property type changed from `object` to no type for status `200`
  - removed the required property `badge/criteria/id` from the response with the `200` status
  - removed the required property `badge/criteria/narrative` from the response with the `200` status
  - removed the required property `image/id` from the response with the `200` status
  - removed `#/components/schemas/Open_Badge_Image` from the `badge/image` response property `allOf` list for the response status `200`
  - added `#/components/schemas/Open_Badge_Criteria, subschema #2` to the `badge/criteria` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Open_Badge_Image, subschema #2` to the `badge/image` response property `anyOf` list for the response status `200`
  - added `#/components/schemas/Open_Badge_Image, subschema #2` to the `image` response property `anyOf` list for the response status `200`
  - the `evidence` response's property default value `` was added for the status `200`

---

[Operation](https://skmtc.dev/navigatr/apis/navigatr-api/docs/v1/badge_assertion/:badge_assertion_id/open_badges/get.md) - [API](https://skmtc.dev/navigatr/apis/navigatr-api.md) - [Page](https://skmtc.dev/navigatr/apis/navigatr-api/changes/v1/badge_assertion/:badge_assertion_id/open_badges/get)