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

client = Retab()

result = client.workflows.experiments.results.get("expresult_1")

print(result.document_id)
print(result.lifecycle.status)
print(result.artifact)

{
  "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
}
Fetch one experiment result by its opaque result_id. Use this to refresh a single document result without re-listing every result for the parent experiment run. 
from retab import Retab

client = Retab()

result = client.workflows.experiments.results.get("expresult_1")

print(result.document_id)
print(result.lifecycle.status)
print(result.artifact)

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

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
result_id
string
required

Response

Successful Response

One experiment block execution for a single document, addressed by experiment_run_id and document_id.

​
id
string
required
​
experiment_run_id
string
required
​
experiment_id
string
required
​
document_id
string
required
​
lifecycle
PendingWorkflowExperimentResult · object
required

The result row has been created but execution has not started.

​
timing
ExperimentResultTiming · object
required
​
block_type
enum<string>
required
Available options:
extract,
classifier,
split,
for_each
​
handle_inputs
Handle Inputs · object
​
handle_outputs
Handle Outputs · object
​
artifact
StepArtifactRef · object

A resource produced by a workflow step.

An (operation, id) reference. The artifact itself carries no payload — consumers dispatch on operation and fetch the referenced record by id.

​
attempt
integer
default:0