---
title: "GET /productReleases"
method: GET
path: "/productReleases"
tags: ["TEA Product Release"]
---

# GET /productReleases

`GET /productReleases`

Returns a list of TEA product releases. Note that multiple product releases may match.

## Query parameters

- `pageOffset` integer
- `pageSize` integer
- `idType` 'CPE' | 'TEI' | 'PURL' — Enumeration of identifiers types
- `idValue` string

## Response `200`

A paginated response containing TEA Product Releases

- PaginatedProductReleaseResponse — A paginated response containing TEA Product Releases
  - `timestamp` string, date-time, required
  - `pageStartIndex` integer, required
  - `pageSize` integer, required
  - `totalResults` integer, required
  - `results` ProductRelease[]
    - `uuid` string, uuid, required — A UUID
    - `product` string, uuid — A UUID
    - `productName` string — Name of the TEA Product this release belongs to
    - `version` string, required — Version number of the product release
    - `createdDate` string, date-time, required — Timestamp
    - `releaseDate` string, date-time — Timestamp
    - `preRelease` boolean — A flag indicating pre-release (or beta) status. May be disabled after the creation of the release object, but can't be enabled after creation of an object.
    - `identifiers` Identifier[] — List of identifiers for the product release
      - `idType` 'CPE' | 'TEI' | 'PURL' — Enumeration of identifiers types
      - `idValue` string — Identifier value
    - `components` ComponentRef[], required — List of component references that compose this product release. A component reference can optionally include the UUID of a specific component release to pin the exact version.
      - `uuid` string, uuid, required — A UUID
      - `release` string, uuid — A UUID

## Other responses

- `400` — Request was Invalid

## Changes

- **2026-02-19** `ff24acccebf4` — 1 warning
  - removed the optional property `allOf[subschema #2]/results/items/cle` from the response with the `200` status
- **2026-02-10** `ff2cb26a75bf` — 1 info
  - added the optional property `allOf[subschema #2]/results/items/cle` to the response with the `200` status
- **2025-09-22** `9c488d21fc27` — 1 info
  - api operation id `getTeaProductReleaseByIdentifier` removed and replaced with `queryTeaProductReleases`
- **2025-09-22** `2d740e575109` — 1 info
  - added the optional property `allOf[subschema #2]/results/items/productName` to the response with the `200` status
- **2025-09-22** `5f6c6e0b74c9` — 1 breaking
  - the response's body type changed from no type to `object` for status `200`

[Full history](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api/changes/productReleases/get.md)

---

[API](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api.md) · [All operations](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api/revisions/2bd6d8b0ff73?raw)