---
title: "Read the immutable catalog release descriptor."
method: GET
path: "/v1/release"
tags: ["Catalog"]
---

# Read the immutable catalog release descriptor.

`GET /v1/release`

## Request

- Base URL: `https://api.sourcey.com`
- URL: `https://api.sourcey.com/v1/release`
- Auth: one of:
  - none
  - HTTP bearer

## Response `200`

Successful response.

- GetCatalogReleaseResponse200
  - `admitted_input_digests` string[], required
  - `artifact_sha256` string, required
  - `bundle` object, required
    - `archive_url` string, uri, required
    - `digest` string, required
    - `verifier_digest` string, required
  - `descriptor` object, required
    - `descriptor_contract` 'sourcey.release-descriptor/v1alpha1', required
    - `release_core` object, required
      - `diff_digest` string, required
      - `parent_release_id` string, nullable, required
      - `release_contract` 'sourcey.release-core/v1alpha1', required
      - `release_sequence` integer, required
      - `snapshot_id` string, required
    - `release_id` string, required
    - `snapshot_core` object, required
      - `artifact_contract` 'sourcey.canonical-artifact/v1alpha1', required
      - `artifact_digest` string, required
      - `compiler_version` string, required
      - `input_set_digest` string, required
      - `policy_as_of` string, date-time, required
      - `release_sequence` integer, required
      - `resource_digests` object, required
      - `root_set_digest` string, required
      - `signer_registry_digest` string, required
      - `snapshot_contract` 'sourcey.snapshot-core/v1alpha1', required
      - `trust_transition_digest` string, nullable, required
    - `snapshot_id` string, required
  - `parent_release_id` string, nullable, required
  - `policy_as_of` string, date-time, required
  - `publication` object, required
    - `digest` string, required
    - `published_at` string, date-time, required
  - `release_contract` 'sourcey.release-read/v1alpha1', required
  - `release_id` string, required
  - `release_sequence` integer, required
  - `resource_digests` object, required
  - `snapshot_id` string, required

## Other responses

- `401`: HTTP 401 response.
- `403`: HTTP 403 response.
- `405`: HTTP 405 response.
- `429`: HTTP 429 response.
- `500`: HTTP 500 response.
- `503`: HTTP 503 response.

---

[API](https://skmtc.dev/sourcey/apis/sourcey-public-api.md) · [All operations](https://skmtc.dev/sourcey/apis/sourcey-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sourcey/apis/sourcey-public-api/revisions/437166b51fa5?raw)