---
title: "GET /release/{uuid}/collections"
method: GET
path: "/release/{uuid}/collections"
tags: ["TEA Release"]
---

# GET /release/{uuid}/collections

`GET /release/{uuid}/collections`

Get the TEA Collections belonging to the TEA Release

## Path parameters

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

## Response `200`

Requested TEA Collection found and returned

- Collection[]
  - `uuid` string, uuid — A UUID
  - `version` integer — TEA Collection version, incremented each time its content changes. Versions start with 1.
  - `date` string, date-time — Timestamp
  - `belongsTo` 'RELEASE' | 'PRODUCT_RELEASE' — Indicates whether a collection belongs to a component release or a product release
  - `updateReason` CollectionUpdateReason — Reason for the update to the TEA collection
    - `type` 'INITIAL_RELEASE' | 'VEX_UPDATED' | 'ARTIFACT_UPDATED' | 'ARTIFACT_ADDED' | 'ARTIFACT_REMOVED' — Type of TEA collection update
    - `comment` string — Free text description
  - `artifacts` Artifact[] — List of TEA artifact objects.
    - `uuid` string, uuid — A UUID
    - `name` string — Artifact name
    - `type` 'ATTESTATION' | 'BOM' | 'BUILD_META' | 'CERTIFICATION' | 'FORMULATION' | 'LICENSE' | 'RELEASE_NOTES' | 'SECURITY_TXT' | 'THREAT_MODEL' | 'VULNERABILITIES' | 'OTHER' — Specifies the type of external reference.
    - `distributionTypes` string[] — List of component distributions types that this artifact applies to. If absent, the artifact applies to all distributions.
    - `formats` ArtifactFormat[] — List of objects with the same content, but in different formats. The order of the list has no significance.
      - `mimeType` string — The MIME type of the document
      - `description` string — A free text describing the artifact
      - `url` string, url — Direct download URL for the artifact
      - `signatureUrl` string, url — Direct download URL for an external signature of the artifact
      - `checksums` Checksum[] — List of checksums for the artifact
        - `algType` 'MD5' | 'SHA-1' | 'SHA-256' | 'SHA-384' | 'SHA-512' | 'SHA3-256' | 'SHA3-384' | 'SHA3-512' | 'BLAKE2b-256' | 'BLAKE2b-384' | 'BLAKE2b-512' | 'BLAKE3' — Checksum algorithm
        - `algValue` string — Checksum value

## Other responses

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

## Changes

- **2025-09-13** `11cad9f1e5e2` — 1 breaking, 1 warning, 2 info
  - added the pattern `^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$` to the `path` request parameter `uuid`
  - removed the optional property `items/artifacts/items/formats/items/mime_type` from the response with the `200` status
  - added the optional property `items/artifacts/items/formats/items/mimeType` to the response with the `200` status
  - added the optional property `items/belongsTo` to the response with the `200` status
- **2025-09-13** `bf409a83ba58` — 2 warning, 2 info
  - removed the optional property `items/artifacts/items/formats/items/mimeType` from the response with the `200` status
  - removed the optional property `items/belongsTo` from the response with the `200` status
  - removed the pattern `^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$` from the `path` request parameter `uuid`
  - added the optional property `items/artifacts/items/formats/items/mime_type` to the response with the `200` status
- **2025-08-17** `4c19b0fe0a36` — 1 info
  - added the optional property `items/artifacts/items/distributionTypes` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/cyclonedx/apis/transparency-exchange-api/changes/release/:uuid/collections/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/5f6c6e0b74c9?raw)