Skip to main content
GET
List experiment runs, newest first. Filter by workflow_id, experiment_id, block_id, lifecycle status, trigger type, date range, or id pagination. For per-document execution data, use List Experiment Run Results; for consensus scores, use Get Experiment Run Metrics. The response uses the canonical Retab list envelope: { "data": [...], "list_metadata": { "before": null, "after": null } }.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

workflow_id
string | null
experiment_id
string | null
block_id
string | null
status
enum<string> | null
Available options:
pending,
queued,
running,
completed,
error,
cancelled
exclude_status
enum<string> | null
Available options:
pending,
queued,
running,
completed,
error,
cancelled
trigger_type
string | null
from_date
string | null
to_date
string | null
sort_by
string
default:created_at
before
string | null
after
string | null
limit
integer
default:20
Required range: 1 <= x <= 100
order
enum<string>
default:desc
Available options:
asc,
desc

Response

Successful Response

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

data
WorkflowExperimentRun · object[]
required
list_metadata
ListMetadata · object
required

Boundary resource IDs for page navigation.