---
title: "Changes to Resolve an identifier to TEA Product Releases"
method: GET
path: "/discovery"
---

# Changes to Resolve an identifier to TEA Product Releases

`GET /discovery`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 14 of 156 revisions.

- **2026-09-22** `d56f299e3e44`: 1 info
- **2026-09-20** `f698addb5d2b`: 8 info
- **2026-09-18** `772035fe6917`: 4 warning
- **2026-09-18** `bf28cb5b51a5`: 1 info
- **2026-09-18** `5cbc102ffdf9`: 1 warning, 1 info
- **2026-09-18** `32a8182795f8`: 1 info
- **2026-09-18** `7a2e1e1ee909`: 1 info
- **2026-09-17** `567221448140`: 1 info
- **2026-09-17** `50e1f48d6f16`: 1 info
- **2026-09-17** `a539fe01ed1a`: 3 info
- **2026-09-16** `99380b4c32ed`: 1 info
- **2026-09-10** `ffc89e57bd5d`: 2 info
- **2025-11-01** `185d61330a30`: 4 breaking
- **2025-11-01** `d5d8bb24d678`: 1 info

## Changes

- **2026-09-22** `d56f299e3e44`: 1 info
  - api operation id `discoveryByTei` removed and replaced with `discover`
- **2026-09-20** `f698addb5d2b`: 8 info
  - added the optional property `message` to the response with the `400` status
  - added the optional property `message` to the response with the `401` status
  - added the optional property `message` to the response with the `403` status
  - added the optional property `message` to the response with the `404` status
  - removed the `OBJECT_NOT_SHAREABLE` enum value from the `error` response property for the response status `400`
  - removed the `OBJECT_NOT_SHAREABLE` enum value from the `error` response property for the response status `401`
  - removed the `OBJECT_NOT_SHAREABLE` enum value from the `error` response property for the response status `403`
  - removed the `OBJECT_NOT_SHAREABLE` enum value from the `error` response property for the response status `404`
- **2026-09-18** `772035fe6917`: 4 warning
  - added the new `INVALID_PAGE_TOKEN` enum value to the `error` response property for the response status `404`
  - added the new `INVALID_REQUEST` enum value to the `error` response property for the response status `404`
  - added the new `NO_ACCEPTABLE_FORMAT` enum value to the `error` response property for the response status `404`
  - added the new `SIGNATURE_NOT_FOUND` enum value to the `error` response property for the response status `404`
- **2026-09-18** `bf28cb5b51a5`: 1 info
  - the `items/servers/items/rootUrl` response's property pattern `^https?://[^/?#@]+(/[^?#\s]*[^/?#\s])?$` was added for the status `200`
- **2026-09-18** `5cbc102ffdf9`: 1 warning, 1 info
  - added the new `NOT_IMPLEMENTED` enum value to the `error` response property for the response status `404`
  - the `items/servers/items/rootUrl` response's property pattern `^https?://[^/?#@]+(/[^?#\s]*[^/?#\s])?$` was removed for the status `200`
- **2026-09-18** `32a8182795f8`: 1 info
  - the `items/servers/items/rootUrl` response's property pattern was changed from `^https?://[^/?#@]+(/[^?#]*[^/?#])?$` to `^https?://[^/?#@]+(/[^?#\s]*[^/?#\s])?$` for the status `200`
- **2026-09-18** `7a2e1e1ee909`: 1 info
  - the `items/servers/items/rootUrl` response's property pattern `^https?://[^/?#@]+(/[^?#]*[^/?#])?$` was added for the status `200`
- **2026-09-17** `567221448140`: 1 info
  - the `items/servers/items/versions/items/` response's property pattern `^(0|[1-9]\d*)\.(0|[1-9]\d*)\.(0|[1-9]\d*)(?:-((?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*)(?:\.(?:0|[1-9]\d*|\d*[a-zA-Z-][0-9a-zA-Z-]*))*))?(?:\+([0-9a-zA-Z-]+(?:\.[0-9a-zA-Z-]+)*))?$` was added for the status `200`
- **2026-09-17** `50e1f48d6f16`: 1 info
  - the `priority` response's property default value `1` was added for the status `200`
- **2026-09-17** `a539fe01ed1a`: 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - the `priority` response's property default value `1` was removed for the status `200`
- **2026-09-16** `99380b4c32ed`: 1 info
  - the `priority` response's property default value `1` was added for the status `200`
- **2026-09-10** `ffc89e57bd5d`: 2 info
  - added the new optional `query` request parameter `purl`
  - the `query` request parameter `tei` became optional
- **2025-11-01** `185d61330a30`: 4 breaking
  - the response's body type changed from `object` to `array` for status `200`
  - removed the required property `productReleaseUuid` from the response with the `200` status
  - removed the required property `rootUrl` from the response with the `200` status
  - removed the required property `versions` from the response with the `200` status
- **2025-11-01** `d5d8bb24d678`: 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api/docs/discovery/get.md) - [API](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api.md) - [Page](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api/changes/discovery/get)