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

client = Retab()

queue = client.workflows.reviews.list(
    workflow_id="wf_1",
    decision_status="pending",
    limit=50,
)

for item in queue.data:
    print(item.id, item.run_id, item.block_id)

{
  "data": [
    {
      "id": "rev_D4J7WZBRV4H7C2SKQJ4NP6W2EY",
      "workflow_id": "wf_1",
      "workflow_version_id": "wfv_1",
      "run_id": "run_abc123",
      "block_id": "block_extract",
      "step_id": "run_abc123_block_extract",
      "parent_step_id": null,
      "iteration_key": null,
      "block_type": "extract",
      "triggered_by": { "kind": "always" },
      "created_at": "2026-05-13T08:14:02.341Z",
      "decision": null
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
List reviews, oldest-created first. Use decision_status="pending" for the open review queue. Use approved, rejected, decided, or all for terminal-review views. 
from retab import Retab

client = Retab()

queue = client.workflows.reviews.list(
    workflow_id="wf_1",
    decision_status="pending",
    limit=50,
)

for item in queue.data:
    print(item.id, item.run_id, item.block_id)

{
  "data": [
    {
      "id": "rev_D4J7WZBRV4H7C2SKQJ4NP6W2EY",
      "workflow_id": "wf_1",
      "workflow_version_id": "wfv_1",
      "run_id": "run_abc123",
      "block_id": "block_extract",
      "step_id": "run_abc123_block_extract",
      "parent_step_id": null,
      "iteration_key": null,
      "block_type": "extract",
      "triggered_by": { "kind": "always" },
      "created_at": "2026-05-13T08:14:02.341Z",
      "decision": null
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Authorizations

​
Api-Key
string
header
required

Query Parameters

​
workflow_id
string | null
​
run_id
string | null
​
block_id
string | null
​
step_id
string | null
​
iteration_key
string | null
​
decision_status
enum<string>
default:pending

Filter by decision state: pending, approved, rejected, decided, or all.

Available options:
pending,
approved,
rejected,
decided,
all
​
before
string | null

Cursor: only return reviews that appear before this review id in the result order. Use list_metadata.before from the previous page.

​
after
string | null

Cursor: only return reviews that appear after this review id in the result order. Use list_metadata.after from the previous page.

​
limit
integer
default:50
Required range: 1 <= x <= 200

Response

Successful Response

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

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

Boundary resource IDs for page navigation.