Skip to main content
GET
/
v1
/
workflows
/
{workflow_id}
/
experiments
/
{experiment_id}
/
runs
from retab import Retab

client = Retab()

result = client.workflows.experiments.runs.list(
    workflow_id="wf_abc123",
    experiment_id="exp_abc",
)
for run in result.runs:
    print(run.id, run.status, run.score, run.created_at)

{
  "runs": [
    {
      "id": "exprun_2",
      "parent_run_id": "exprun_1",
      "block_config": { "model": "gpt-5", "json_schema": { "type": "object" } },
      "definition_fingerprint": "0ff93ddc7cefcb42",
      "documents_fingerprint": "ddd95baadce6045f",
      "status": "completed",
      "block_kind": "extract",
      "score": 0.87,
      "document_count": 12,
      "error_count": 0,
      "n_consensus": 5,
      "created_at": "2026-05-02T11:00:00Z",
      "completed_at": "2026-05-02T11:04:18Z",
      "duration_ms": 258221,
      "job_id": "job_99"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.retab.com/llms.txt

Use this file to discover all available pages before exploring further.

List historical runs for one experiment, newest first. Each row is a slim projection of an ExperimentRun (status, score, fingerprints, timing) — the fields needed for a runs table. For the underlying per-document execution data, use Get Experiment Content; for consensus scores, use Get Experiment Metrics. 
from retab import Retab

client = Retab()

result = client.workflows.experiments.runs.list(
    workflow_id="wf_abc123",
    experiment_id="exp_abc",
)
for run in result.runs:
    print(run.id, run.status, run.score, run.created_at)

{
  "runs": [
    {
      "id": "exprun_2",
      "parent_run_id": "exprun_1",
      "block_config": { "model": "gpt-5", "json_schema": { "type": "object" } },
      "definition_fingerprint": "0ff93ddc7cefcb42",
      "documents_fingerprint": "ddd95baadce6045f",
      "status": "completed",
      "block_kind": "extract",
      "score": 0.87,
      "document_count": 12,
      "error_count": 0,
      "n_consensus": 5,
      "created_at": "2026-05-02T11:00:00Z",
      "completed_at": "2026-05-02T11:04:18Z",
      "duration_ms": 258221,
      "job_id": "job_99"
    }
  ]
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
workflow_id
string
required
​
experiment_id
string
required

Query Parameters

​
access_token
string | null

Response

Successful Response

​
runs
ExperimentRunSummary · object[]
required