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

# GET /components

`GET /components`

Returns a list of TEA components. Note that multiple components may match.

## Query parameters

- `idType` 'CPE' | 'TEI' | 'PURL' | 'COMPLIANCE_DOCUMENT' — Enumeration of identifiers types
- `idValue` string
- `pageSize` integer
- `pageToken` string
- `sortField` 'name'
- `sortOrder` 'asc' | 'desc'

## Response `200`

A paginated response containing TEA Components

- PaginatedComponentResponse — A paginated response containing TEA Components
  - `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` Component[], required
    - `uuid` string, uuid, required — A UUID
    - `name` string, required — Component name
    - `identifiers` Identifier[], required — List of identifiers for the component
      - `idType` 'CPE' | 'TEI' | 'PURL' | 'COMPLIANCE_DOCUMENT' — Enumeration of identifiers types
      - `idValue` string — Identifier 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` — 1 breaking
  - the response property `allOf[#/components/schemas/pagination-details]/nextPageToken` became optional for the status `200`
- **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
- **2026-03-12** `f81b8dd2be66` — 5 breaking, 3 warning, 1 info
  - for the `query` request parameter `pageSize`, default value was changed from `100` to `25`
  - removed the required property `allOf[#/components/schemas/pagination-details]/pageSize` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/pagination-details]/pageStartIndex` from the response with the `200` status
  - removed the required property `allOf[#/components/schemas/pagination-details]/timestamp` from the response with the `200` status
  - …5 more

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