Get Experiment

Retrieve a single experiment.

Identified by experiment_id. Returns the experiment along with its latest-run status, score, staleness, and schema-drift detection. Returns 404 if no experiment with that ID exists.

GET /v1/workflows/experiments/{experiment_id}

Python

from retab import Retab

client = Retab()

experiment = client.workflows.experiments.get(
    experiment_id="exp_abc",
)

200

{
  "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"
}

Fetch one experiment by id. The response includes the latest run status, score, staleness, and schema-drift information — the same shape as the listing endpoint.

Python

from retab import Retab

client = Retab()

experiment = client.workflows.experiments.get(
    experiment_id="exp_abc",
)

200

{
  "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"
}

Authorizations

Api-Key · string · header · required

Path Parameters

experiment_id · string · required

Response

200

application/json

Successful Response

An experiment that evaluates a workflow block against a set of documents, with its latest run status and score.

id · string · required

workflow_id · string · required

block_id · string · required

n_consensus · enum<integer> · required

Available options: 3, 5, 7

name · string · required

block_type · enum<string> · required

Available options: extract, classifier, split, for_each

document_count · integer · default: 0

last_run_id · string | null

created_at · string<date-time>

When the experiment was created

updated_at · string<date-time>

When the experiment was last updated

status · enum<string> · default: draft

Available options: draft, processing, completed, failed, cancelled

score · number | null

is_stale · boolean · default: false

freshness · ArtifactFreshness · object

Show child attributes

schema_drift · enum<string> · default: unknown

Available options: none, partial, drifted, unknown

schema_drift_detail · string | null

drift · ArtifactDrift · object

Show child attributes