---
title: "List a document's versions"
method: GET
path: "/documents/{document_id}/versions"
tags: ["Versions"]
---

# List a document's versions

`GET /documents/{document_id}/versions`

## Request

- Base URL: `https://app.jitprompt.com`
- URL: `https://app.jitprompt.com/documents/{document_id}/versions`
- Auth: HTTP bearer

The kept versions of a document, newest (current) first. How many are
kept depends on the plan (`features.versions_kept` in `GET /usage`).

## Path parameters

- `document_id` string, required

## Response `200`

Successful Response

- Version[]
  - `version` integer, required
  - `source_name` string, required
  - `size_bytes` integer, required
  - `kind` 'upload' | 'replace' | 'restore' | 'baseline', required
  - `restored_from` integer, nullable, required
  - `created_by` string, nullable, required
  - `created_at` string, date-time, required
  - `current` boolean, required

## Other responses

- `422`: Validation Error

---

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