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

client = Retab()

page = client.workflows.experiments.list(workflow_id="wf_abc123")
for exp in page.data:
    print(exp.id, exp.name, exp.status, exp.score)

{
  "data": [
    {
      "id": "exp_abc",
      "workflow_id": "wf_abc123",
      "block_id": "extract-invoice",
      "block_kind": "extract",
      "n_consensus": 5,
      "document_count": 12,
      "name": "Q1 invoices",
      "last_run_id": "exprun_1",
      "status": "completed",
      "score": 0.87,
      "is_stale": false,
      "schema_drift": "none",
      "schema_drift_detail": null,
      "created_at": "2026-05-01T14:30:00Z",
      "updated_at": "2026-05-02T09:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}
List all experiments attached to a workflow, with the latest run’s status, score, staleness flag, and schema-drift state. The response uses the canonical Retab list envelope: { "data": [...], "list_metadata": { "before": null, "after": null } }. 
from retab import Retab

client = Retab()

page = client.workflows.experiments.list(workflow_id="wf_abc123")
for exp in page.data:
    print(exp.id, exp.name, exp.status, exp.score)

{
  "data": [
    {
      "id": "exp_abc",
      "workflow_id": "wf_abc123",
      "block_id": "extract-invoice",
      "block_kind": "extract",
      "n_consensus": 5,
      "document_count": 12,
      "name": "Q1 invoices",
      "last_run_id": "exprun_1",
      "status": "completed",
      "score": 0.87,
      "is_stale": false,
      "schema_drift": "none",
      "schema_drift_detail": null,
      "created_at": "2026-05-01T14:30:00Z",
      "updated_at": "2026-05-02T09:00:00Z"
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Authorizations

​
Api-Key
string
header
required

Query Parameters

​
workflow_id
string
required
​
before
string | null
​
after
string | null
​
limit
integer
default:50
Required range: 1 <= x <= 100
​
order
enum<string>
default:desc
Available options:
asc,
desc

Response

Successful Response

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

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

Boundary resource IDs for page navigation.