---
title: "List a Spec's published versions"
method: GET
path: "/v1/specs/{id}/versions"
tags: ["Specs"]
---

# List a Spec's published versions

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

## Request

- Base URL: `https://api.talonic.com`
- URL: `https://api.talonic.com/v1/specs/{id}/versions`
- Auth: HTTP bearer

The Spec's published versions, newest first — this is where a Spec's
"v3" lives.

Not to be confused with `GET /v1/schemas/{id}/versions`, which reads the
unrelated legacy schema-version counter. A Spec-authored schema never
advances that one, so it is normally empty for these schemas.

## Path parameters

- `id` string, uuid, required

## Response `200`

Published versions, newest first.

- object
  - `data` SpecVersion[]
    - `version` integer
    - `content_hash` string: sha256 of the canonical Spec document — identical hashes are identical Specs.
    - `created_at` string, date-time
    - `is_materialized` boolean: Whether this is the version currently live on the schema.

## Other responses

- `401`: Missing or invalid API key.
- `404`: Spec not found

---

[API](https://skmtc.dev/talonic/apis/talonic-api.md) · [All operations](https://skmtc.dev/talonic/apis/talonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/talonic/apis/talonic-api/revisions/678fe5f8c9c3?raw)