> ## Documentation Index
> Fetch the complete documentation index at: https://surfacedocs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# List Versions

> GET /v1/documents/{document_id}/versions

# List Versions

```
GET /v1/documents/{document_id}/versions
```

List all versions of a document. Returns version summaries in chronological order.

## Request

### Headers

| Header      | Required | Description  |
| ----------- | -------- | ------------ |
| `X-API-Key` | Yes      | Your API key |

### Path Parameters

| Parameter     | Type   | Required | Description     |
| ------------- | ------ | -------- | --------------- |
| `document_id` | string | Yes      | The document ID |

### Example

```bash theme={null}
curl https://api.surfacedocs.dev/v1/documents/doc_abc123/versions \
  -H "X-API-Key: sd_live_..."
```

## Response

**Status: 200 OK**

```json theme={null}
{
  "versions": [
    {
      "version": 1,
      "title": "Daily Report — Feb 13",
      "block_count": 5,
      "created_at": "2026-02-13T10:00:00Z"
    },
    {
      "version": 2,
      "title": "Daily Report — Feb 14",
      "block_count": 6,
      "created_at": "2026-02-14T10:30:00Z"
    }
  ],
  "current_version": 2
}
```