Versions

List document versions

List versions for a document with cursor-based pagination.

get/v1beta/documents/{document_id}/versions

Path parameters

document_idstring required

Document ID to list versions for. Pattern: doc_[0-9a-hjkmnp-tv-z]{26}

Query parameters

page_tokenstring

Opaque pagination token from a previous response. Pass next_page_token or prev_page_token from a previous response to continue pagination. Empty or omitted for the first page.

Example:eyJpZCI6InZlcl8wMWgyYWJjZDEyMzRlZmdoNTY3OGprbW5wdCIsImQiOiJuZXh0IiwiZiI6eyJkb2NfaWQiOiJkb2NfMDFoMnhjZWpxdGYybmJyZXh4M3ZxamhwNDEifX0

Opaque pagination token from a previous response. Pass next_page_token or prev_page_token from a previous response to continue pagination. Empty or omitted for the first page.

page_sizeinteger

Maximum number of items to return per page (1-100). Default: 50.

Response

Success

Example response

{
  "items": [
    {
      "created_by": {
        "id": "user_01h2xcejqtf2nbrexx3vqjhp41"
      },
      "document_id": "doc_01h2xcejqtf2nbrexx3vqjhp41",
      "id": "ver_01h2abcd1234efgh5678jkmnpt",
      "title": "Version 2.0",
      "url": "https://app.factify.com/d/01h2xcejqtf2nbrexx3vqjhp41/v/1"
    }
  ],
  "pagination": {
    "next_page_token": "eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJuZXh0In0",
    "prev_page_token": "eyJpZCI6ImRvY18wMWgyeGNlanF0ZjJuYnJleHgzdnFqaHA0MSIsImQiOiJwcmV2In0"
  }
}

Changes

Changed in 1 of the 50 revisions of this API.24

Mar 5, 2026a7e69986914e24See the full diff
- ●
  added the new bot enum value to the /// response property for the response status
  response-property-enum-value-added
- ●
  added the new user enum value to the /// response property for the response status
  response-property-enum-value-added
- ○
  added discriminator to // response property for the response status
  response-property-discriminator-added
- ○
  removed the service_account enum value from the /// response property for the response status
  response-property-enum-value-removed
- ○
  removed the user_account enum value from the /// response property for the response status
  response-property-enum-value-removed
- ○
  the /// response's property pattern was changed from ^(user|svc)_[0-9a-hjkmnp-tv-z]{26}$ to ^(user|bot)_[0-9a-hjkmnp-tv-z]{26}$ for the status
  response-property-pattern-changed
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history