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

client = Retab()

results = client.workflows.experiments.runs.results.list("exprun_2")
for result in results.data:
    print(result.document_id, result.lifecycle.status, result.artifact)

{
  "data": [
    {
      "id": "expresult_1",
      "run_id": "exprun_2",
      "experiment_id": "exp_abc",
      "document_id": "expdoc_xyz",
      "block_kind": "extract",
      "lifecycle": { "status": "completed" },
      "timing": {
        "started_at": "2026-05-02T11:00:01Z",
        "completed_at": "2026-05-02T11:00:05Z",
        "duration_ms": 4120
      },
      "handle_inputs": {
        "input-document-0": { "type": "file", "filename": "invoice_q1.pdf" }
      },
      "artifact": { "operation": "extraction", "id": "ext_xyz" },
      "attempt": 0
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

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 per-document results for one experiment run. Results are addressed under the parent run by document_id. The response uses the canonical Retab list envelope: { "data": [...], "list_metadata": { "before": null, "after": null } }. 
from retab import Retab

client = Retab()

results = client.workflows.experiments.runs.results.list("exprun_2")
for result in results.data:
    print(result.document_id, result.lifecycle.status, result.artifact)

{
  "data": [
    {
      "id": "expresult_1",
      "run_id": "exprun_2",
      "experiment_id": "exp_abc",
      "document_id": "expdoc_xyz",
      "block_kind": "extract",
      "lifecycle": { "status": "completed" },
      "timing": {
        "started_at": "2026-05-02T11:00:01Z",
        "completed_at": "2026-05-02T11:00:05Z",
        "duration_ms": 4120
      },
      "handle_inputs": {
        "input-document-0": { "type": "file", "filename": "invoice_q1.pdf" }
      },
      "artifact": { "operation": "extraction", "id": "ext_xyz" },
      "attempt": 0
    }
  ],
  "list_metadata": {
    "before": null,
    "after": null
  }
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
run_id
string
required

Query Parameters

​
limit
integer
default:100
Required range: 1 <= x <= 1000

Response

Successful Response

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

Boundary resource IDs for page navigation.