Skip to main content
GET
/
v1
/
workflows
/
reviews
/
versions
from retab import Retab

client = Retab()

page = client.workflows.reviews.versions.list(
    review_id="rev_D4J7WZBRV4H7C2SKQJ4NP6W2EY",
    limit=50,
)
for version in page.data:
    print(version.id, version.parent_id)

{
  "data": [
    {
      "id": "rvr_HQ6ZZBQTJLSGLZQCWBSI25SCOQ",
      "review_id": "rev_D4J7WZBRV4H7C2SKQJ4NP6W2EY",
      "parent_id": null,
      "author": {
        "kind": "model",
        "id": "retab-small",
        "display_name": "Retab Small"
      },
      "snapshot": { "total_amount": 505, "vendor_name": "Acme Corp" },
      "note": null,
      "created_at": "2026-05-13T08:14:02.341Z"
    },
    {
      "id": "rvr_PFBGO3R6T3PG5O37U4Y3NDXWAM",
      "review_id": "rev_D4J7WZBRV4H7C2SKQJ4NP6W2EY",
      "parent_id": "rvr_HQ6ZZBQTJLSGLZQCWBSI25SCOQ",
      "author": {
        "kind": "human",
        "id": "user_42",
        "display_name": "Dana Rivera"
      },
      "snapshot": { "total_amount": 325, "vendor_name": "Acme Corp" },
      "note": "Corrected total.",
      "created_at": "2026-05-13T09:05:00.000Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
List versions for one review, paginated with keyset cursors. review_id is required — listing versions across all reviews is not exposed. 
from retab import Retab

client = Retab()

page = client.workflows.reviews.versions.list(
    review_id="rev_D4J7WZBRV4H7C2SKQJ4NP6W2EY",
    limit=50,
)
for version in page.data:
    print(version.id, version.parent_id)

{
  "data": [
    {
      "id": "rvr_HQ6ZZBQTJLSGLZQCWBSI25SCOQ",
      "review_id": "rev_D4J7WZBRV4H7C2SKQJ4NP6W2EY",
      "parent_id": null,
      "author": {
        "kind": "model",
        "id": "retab-small",
        "display_name": "Retab Small"
      },
      "snapshot": { "total_amount": 505, "vendor_name": "Acme Corp" },
      "note": null,
      "created_at": "2026-05-13T08:14:02.341Z"
    },
    {
      "id": "rvr_PFBGO3R6T3PG5O37U4Y3NDXWAM",
      "review_id": "rev_D4J7WZBRV4H7C2SKQJ4NP6W2EY",
      "parent_id": "rvr_HQ6ZZBQTJLSGLZQCWBSI25SCOQ",
      "author": {
        "kind": "human",
        "id": "user_42",
        "display_name": "Dana Rivera"
      },
      "snapshot": { "total_amount": 325, "vendor_name": "Acme Corp" },
      "note": "Corrected total.",
      "created_at": "2026-05-13T09:05:00.000Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Authorizations

​
Api-Key
string
header
required

Query Parameters

​
review_id
string
required

Required: the review whose versions to list.

​
before
string | null
​
after
string | null
​
limit
integer
default:50
Required range: 1 <= x <= 200

Response

Successful Response

A page of WorkflowReviewVersion resources. data holds the items and list_metadata carries the before/after cursors; pass after to fetch the next page.

​
data
WorkflowReviewVersion · object[]
required
​
list_metadata
ListMetadata · object
required

Boundary resource IDs for page navigation.