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

# GET /componentRelease/{uuid}

`GET /componentRelease/{uuid}`

Get the TEA Component Release with its latest collection

## Path parameters

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

## Response `200`

Requested TEA Component Release and its latest Collection found and returned

- ComponentReleaseWithCollection — A TEA Component Release combined with its latest collection
  - `release` Release, required — A TEA Component Release
    - `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
  - `latestCollection` Collection, required — A collection of security-related documents
    - `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` 'COMPONENT_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, required — A UUID
      - `version` integer — An integer with default value 1. Together with *uuid* uniquely identifies the TEA Artifact. This field can be used to designate successive, immutable revisions of an artefact content (e.g. an updated VEX file).
      - `name` string — Name of TEA Artifact
      - `type` 'ATTESTATION' | 'BOM' | 'BUILD_META' | 'CERTIFICATION' | 'FORMULATION' | 'LICENSE' | 'RELEASE_NOTES' | 'SECURITY_TXT' | 'THREAT_MODEL' | 'VULNERABILITIES' | 'OTHER', required — Specifies the type of external reference.
      - `createdDate` string, date-time — Timestamp
      - `distributionIds` Uuid[] — List of TEA Component Release distributions that this TEA Artifact applies to. If absent or empty, the TEA Artifact applies to all distributions.
      - `formats` ArtifactFormat[], required — List of objects with the same content, but in different formats. The order of the list has no significance.
        - `mediaType` string — The Media Type of the document
        - `description` string — A free text describing the TEA Artifact
        - `url` string, url — Direct download URL for the TEA Artifact
        - `signatureUrl` string, url — Direct download URL for an external signature of the TEA Artifact
        - `checksums` Checksum[] — List of checksums for the TEA Artifact
          - `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

---

[API](https://skmtc.net/cyclonedx/apis/transparency-exchange-api.md) · [All operations](https://skmtc.net/cyclonedx/apis/transparency-exchange-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cyclonedx/transparency-exchange-api/versions/a1fc035210ca/schema)