---
title: "Get document revisions"
method: GET
path: "/documents/document-revisions"
tags: ["Document AI — DMS"]
---

# Get document revisions

`GET /documents/document-revisions`

## Request

- Base URL: `https://api.paperoffice.ai/latest`
- URL: `https://api.paperoffice.ai/latest/documents/document-revisions`
- Auth: HTTP bearer

po_revisions_get_document_revisions: Get document version history — all changes, who made them and when. Accepts documents_id or pofid. Empty history means no document_revisions rows yet (not tier-blocked). Keywords: revisions, version...

## Query parameters

- `pofid` string, required
- `limit` integer
- `offset` integer
- `action` string
- `field_key` string
- `date_from` string, date
- `date_to` string, date

## Response `200`

Success

- object: Dokument-Revisionen
  - `status` 'success' | 'error', required: HTTP-Level Status
  - `job_id` string, required
  - `message` string: Menschenlesbare Statusmeldung
  - `pipeline` string
  - `operation` string: Ausgefuehrte Operation
  - `processing_time` string: Gesamte Verarbeitungszeit inkl. Queue (Format: 123.45ms)
  - `result` object, required: Das eigentliche Verarbeitungsergebnis
    - `status` 'completed' | 'failed' | 'timeout': Job-Level Status
    - `message` string: Pipeline-spezifische Statusmeldung
    - `duration_ms` string: Reine Pipeline-Verarbeitungszeit in ms
    - `output` object
      - `revisions` object[]
        - `revision_id` number
        - `created_at` string, date-time
        - `created_by` string
        - `comment` string
        - `file_size` number
      - `total` number

## Other responses

- `4XX`: Error
- `5XX`: Error

---

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