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

curl https://api.surfacedocs.dev/v1/documents/doc_abc123/versions \
  -H "X-API-Key: sd_live_..."

Response

Status: 200 OK

{
  "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
}