---
title: "List versions for a public library"
method: GET
path: "/v1/libraries/{identifier}/versions"
tags: ["Libraries"]
---

# List versions for a public library

`GET /v1/libraries/{identifier}/versions`

Bearer API key required. Returns 401 for anonymous callers.

## Path parameters

- `identifier` string, required

## Query parameters

- `page_size` integer
- `start_cursor` string

## Response `200`

Versions list

- LibraryVersionList — Paginated list of `LibraryVersion` objects for a single library. Standard list envelope. Versions are sorted newest first.
  - `object` 'list', required
  - `data` LibraryVersion[], required
    - `object` 'library_version', required
    - `id` string, uuid, required
    - `library_id` string, uuid, required
    - `branch` string, nullable — Git branch name. Null for non-Git sources or when the version is tag-only.
    - `tag` string, nullable — Released git tag (e.g. `v15.1.8`) when present. The newest untagged version is returned as `"latest"` to give callers a stable handle.
    - `commit_hash` string, nullable — Git commit SHA. Null for non-Git sources.
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `next_cursor` string, nullable, required
  - `has_more` boolean, required

## Other responses

- `401` — Missing or invalid bearer token
- `404` — Resource not found
- `500` — Internal server error

---

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