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

client = Retab()

job = client.workflows.experiments.runs.get_job(
    workflow_id="wf_abc123",
    experiment_id="exp_abc",
    run_id="exprun_1",
    document_id="expdoc_xyz",
)
print(job.status, job.artifact, job.error)

{
  "id": "expjob_1",
  "run_id": "exprun_1",
  "experiment_id": "exp_abc",
  "document_id": "expdoc_xyz",
  "status": "completed",
  "block_kind": "extract",
  "handle_inputs": {
    "input-document-0": { "type": "file", "filename": "invoice_q1.pdf" }
  },
  "artifact": { "operation": "extraction", "id": "ext_xyz" },
  "duration_ms": 4120,
  "attempt": 0,
  "is_placeholder": false,
  "created_at": "2026-05-02T11:00:00Z",
  "started_at": "2026-05-02T11:00:01Z",
  "completed_at": "2026-05-02T11:00:05Z"
}

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.

Get one document’s execution job inside a specific experiment run. Use this to inspect a single document’s outcome — its handle inputs, the canonical artifact the block produced, and any error message. For the full run’s content (one job per document), use Get Experiment Content. 
from retab import Retab

client = Retab()

job = client.workflows.experiments.runs.get_job(
    workflow_id="wf_abc123",
    experiment_id="exp_abc",
    run_id="exprun_1",
    document_id="expdoc_xyz",
)
print(job.status, job.artifact, job.error)

{
  "id": "expjob_1",
  "run_id": "exprun_1",
  "experiment_id": "exp_abc",
  "document_id": "expdoc_xyz",
  "status": "completed",
  "block_kind": "extract",
  "handle_inputs": {
    "input-document-0": { "type": "file", "filename": "invoice_q1.pdf" }
  },
  "artifact": { "operation": "extraction", "id": "ext_xyz" },
  "duration_ms": 4120,
  "attempt": 0,
  "is_placeholder": false,
  "created_at": "2026-05-02T11:00:00Z",
  "started_at": "2026-05-02T11:00:01Z",
  "completed_at": "2026-05-02T11:00:05Z"
}

Authorizations

​
Api-Key
string
header
required

Path Parameters

​
workflow_id
string
required
​
experiment_id
string
required
​
run_id
string
required
​
document_id
string
required

Query Parameters

​
access_token
string | null

Response

Successful Response

Execution content for one document job inside an experiment run.

​
id
string
required
​
run_id
string
required
​
experiment_id
string
required
​
document_id
string
required
​
status
enum<string>
required
Available options:
pending,
running,
completed,
error
​
block_kind
enum<string>
required
Available options:
extract,
classifier,
split,
for_each
​
handle_inputs
Handle Inputs · object
​
artifact
StepArtifactRef · object

Canonical persisted resource produced by a workflow step.

Uniformly a (operation, id) ref into a backing collection. The artifact itself carries no payload — consumers dispatch on operation and fetch the backing record by id.

​
error
string | null
​
duration_ms
integer | null
​
created_at
string<date-time> | null
​
started_at
string<date-time> | null
​
completed_at
string<date-time> | null
​
attempt
integer
default:0
​
is_placeholder
boolean
default:false