---
title: "GET /component/{uuid}/releases"
method: GET
path: "/component/{uuid}/releases"
tags: ["TEA Component"]
---

# GET /component/{uuid}/releases

`GET /component/{uuid}/releases`

Get releases of the component

## Path parameters

- `uuid` string, uuid, required — A UUID

## Query parameters

- `pageSize` integer
- `pageToken` string
- `sortField` 'createdDate' | 'releaseDate' | 'version'
- `sortOrder` 'asc' | 'desc'

## Response `200`

A paginated response containing TEA Component Releases

- PaginatedComponentReleaseResponse — A paginated response containing TEA Component Releases
  - `hasNext` boolean, required — A flag (to aid clients) to know whether there is a next page of results to fetch. `nextPageToken` will always be supplied, hence this hint is included to aid clients.
  - `nextPageToken` string, required — A token that can be used in a following request to retrieve the next page or results. It must always be supplied in responses.
  - `results` Release[], required
    - `uuid` string, uuid, required — A UUID
    - `component` string, uuid — A UUID
    - `componentName` string — Name of the TEA Component this release belongs to
    - `version` string, required — Version number
    - `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 component
      - `idType` 'CPE' | 'TEI' | 'PURL' | 'COMPLIANCE_DOCUMENT' — Enumeration of identifiers types
      - `idValue` string — Identifier value
    - `distributions` ReleaseDistribution[] — List of different formats of this component release
      - `distributionId` string, uuid, required — A UUID
      - `description` string — Free-text description of the distribution.
      - `identifiers` Identifier[] — List of identifiers specific to this distribution.
        - `idType` 'CPE' | 'TEI' | 'PURL' | 'COMPLIANCE_DOCUMENT' — Enumeration of identifiers types
        - `idValue` string — Identifier value
      - `url` string, url — Direct download URL for the distribution.
      - `signatureUrl` string, url — Direct download URL for the distribution's external signature.
      - `checksums` Checksum[] — List of checksums for the distribution.
        - `algType` 'MD5' | 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512' | 'SHA3-256' | 'SHA3-384' | 'SHA3-512' | 'BLAKE2b-256' | 'BLAKE2b-384' | 'BLAKE2b-512' | 'BLAKE3', required — Checksum algorithm
        - `algValue` string, required — Checksum value

## Other responses

- `400` — Request was Invalid
- `404` — Object requested by identifier not found

## Changes

- **2026-07-17** `a1fc035210ca` — 1 info
  - the response property `allOf[#/components/schemas/pagination-details]/nextPageToken` became required for the status `200`
- **2026-06-03** `329e2334e92a` — 1 breaking
  - the response property `allOf[#/components/schemas/pagination-details]/nextPageToken` became optional for the status `200`
- **2026-03-12** `966ee7965a6f` — 1 breaking, 5 info
  - the response's body type/format changed from `array`/`` to ``/`` for status `200`
  - added the new optional `query` request parameter `pageSize`
  - added the new optional `query` request parameter `pageToken`
  - added the new optional `query` request parameter `sortField`
  - …2 more
- **2026-03-11** `397c41d0b6c9` — 2 warning
  - added the new `COMPLIANCE_DOCUMENT` enum value to the `items/distributions/items/identifiers/items/idType` response property for the response status `200`
  - added the new `COMPLIANCE_DOCUMENT` enum value to the `items/identifiers/items/idType` response property for the response status `200`
- …earlier changes not shown

[Full history](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api/changes/component/:uuid/releases/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-service-production.skmtc.workers.dev/v1/apis/cyclonedx/transparency-exchange-api/revisions/a1fc035210ca/schema)