---
title: "Get catalog version"
method: GET
path: "/v1/catalog/versions/{id}"
tags: ["Catalog"]
---

# Get catalog version

`GET /v1/catalog/versions/{id}`

Retrieve a single catalog version.

## Path parameters

- `id` string, required

## Response `200`

- CatalogVersion
  - `id` string, required — Catalog version ID.
  - `version` number, required — Monotonic version number assigned to the catalog version.
  - `status` 'draft' | 'published' | 'archived', required — Catalog version status. Draft versions contain unpublished changes, published versions are live, and archived versions are discarded drafts.
  - `name` string, nullable, required — Optional display name for the catalog version.
  - `description` string, nullable, required — Optional internal description for the catalog version.
  - `base_version_id` string, nullable, required — ID of the published catalog version this version was created from.
  - `revert_of_version_id` string, nullable, required — ID of the published catalog version restored by this revert, or null when the version was not created by a revert.
  - `source_file_name` string, nullable, required — Name of the source import file that created this catalog version, or null when the version was not imported.
  - `resource_count` number, nullable, required — Number of resources tracked in the catalog snapshot.
  - `published_at` string, date-time, nullable, required — Catalog version publication date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `created_at` string, date-time, required — Catalog version creation date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
  - `updated_at` string, date-time, required — Catalog version last update date. UTC date time string in the [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.

## Other responses

- `403` — Catalog versioning not enabled.
- `404` — Version not found.

---

[API](https://skmtc.dev/hyperline/apis/hyperline-api.md) · [All operations](https://skmtc.dev/hyperline/apis/hyperline-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperline/hyperline-api/revisions/19fa5f22e39b/schema)