---
title: "GET /componentReleases"
method: GET
path: "/componentReleases"
tags: ["TEA Component Release"]
---

# GET /componentReleases

`GET /componentReleases`

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

## Query parameters

- `idType` 'CPE' | 'TEI' | 'PURL' | 'COMPLIANCE_DOCUMENT' — Enumeration of identifiers types
- `idValue` string
- `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 indicating whether there is another page of results to fetch. When `hasNext` is `true`, `nextPageToken` MUST be present. When `hasNext` is `false`, `nextPageToken` MUST NOT be included.
  - `nextPageToken` string — An opaque token that can be used in a following request to retrieve the next page of results. This field MUST be present when `hasNext` is `true`. This field MUST NOT be included when `hasNext` is `false`.
  - `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. For paginated requests, this includes malformed, invalid, expired, or conflicting `pageToken` values, including conflicts with continuation parameters or path parameters.

## Changes

- **2026-06-03** `329e2334e92a` — 3 breaking, 3 info
  - for the `query` request parameter `sortField`, default value was changed from `name` to `createdDate`
  - removed the enum value `name` from the `query` request parameter `sortField`
  - the response property `allOf[#/components/schemas/pagination-details]/nextPageToken` became optional for the status `200`
  - added the new enum value `createdDate` to the `query` request parameter `sortField`
  - …2 more
- **2026-03-13** `cd4307a3ff32` — 2 info
  - added the new optional `query` request parameter `idType`
  - added the new optional `query` request parameter `idValue`
- **2026-03-12** `966ee7965a6f` — 1 breaking, 2 warning, 4 info
  - the response's body type/format changed from `object`/`` to ``/`` for status `200`
  - deleted the `query` request parameter `idType`
  - deleted the `query` request parameter `idValue`
  - added the new optional `query` request parameter `pageToken`
  - …3 more
- **2026-03-12** `3f8e4daee7e5` — 1 info
  - added the required property `allOf[#/components/schemas/pagination-details]/hasNext` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api/changes/componentReleases/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/329e2334e92a/schema)