---
title: "Read an immutable retained catalog release."
method: GET
path: "/v1/releases/{release_id}"
tags: ["Catalog"]
---

# Read an immutable retained catalog release.

`GET /v1/releases/{release_id}`

## Request

- Base URL: `https://api.sourcey.com`
- URL: `https://api.sourcey.com/v1/releases/{release_id}`
- Auth: one of:
  - none
  - HTTP bearer

## Path parameters

- `release_id` string, required

## Response `200`

Successful response.

- GetCatalogReleaseByIdResponse200
  - `admitted_input_digests` string[], required
  - `artifact_sha256` string, required
  - `bundle` object, required
    - `archive_url` string, uri, required
    - `digest` string, required
    - `verifier_digest` 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

- `400`: Invalid request.
- `401`: HTTP 401 response.
- `403`: HTTP 403 response.
- `404`: Resource not found.
- `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)