Versions

List document versions

Changed on Mar 5, 2026

List versions for a document with cursor-based pagination.

get/v1beta/documents/{document_id}/versions

Request

Base URL
https://api.factify.com
URL
https://api.factify.com/v1beta/documents/{document_id}/versions
Auth
HTTP bearer

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

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

Mar 5, 2026a7e69986914e Revision changes
- warning
  added the new bot enum value to the /// response property for the response status
- warning
  added the new user enum value to the /// response property for the response status
- info
  added discriminator to // response property for the response status
- info
  removed the service_account enum value from the /// response property for the response status
- info
  removed the user_account enum value from the /// response property for the response status
- info
  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
Feb 19, 202664f492271548 Revision changes
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- breaking
  removed the required property from the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the optional property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status
- info
  added the required property to the response with the status

Operation history (4 revisions)