Skip to main content
GET
Rate limit tier: general, 600 requests/min. See Rate limits. Fetches a run by its run_id. The path is flat: no workflow id, and no /results/ sub-path. The response carries the run’s status and its results envelope together, so reading a completed run costs one round-trip.

Status model

The endpoint always returns 200 while the run exists. An extraction in flight raises no precondition error. Poll until status is terminal. A run that ended in error or cancelled stays readable with results: null. The results envelope carries the parse, classifications, splits, extractions and edits sections. Each extractions entry carries its own validations[]. This is the same envelope v2 returned from its /results/ route: only the read path changed. See Runs & results for what each section holds. Parse documents the parse section. The samples below shorten blocks[] to one block. Field values in extractions[] are strings on the wire. An unknown id returns 404, as does a run belonging to another organization.

Extracted fields

Each entry in extractions[].fields maps a field name to its extracted value:

evidence entries

consolidation

A long document is extracted in parts. When the parts give answers for a field that cannot be combined, the field gets no value, and consolidation lists each answer so you can check the document and enter the right one.

Filled forms (edits[])

A workflow with an Edit node fills the blank form it was given and returns edits[] alongside the other sections. edits[] holds one entry per file the node processed. Each entry lists every form field detected in the document, the value written into it, and a link to the filled PDF. The key is always present, and is [] when the workflow has no edit node.

Authorizations

Authorization
string
header
required

API key issued from app.anyformat.ai/api-key. Send as Authorization: Bearer <key>.

Path Parameters

run_id
string
required

Response

Successful Response

Flat single-run read: lifecycle status plus results inline.

results is null until the run reaches processed, then carries the results envelope — no separate results endpoint, no 412 while in flight.

id
string
required

Unique identifier of the run (hyphenated UUID).

Example:

"069dcc2c-e14c-7606-8000-2ee4fb17b4f9"

workflow_id
string
required

The workflow this run executed (hyphenated UUID).

Example:

"0686bb97-8c30-70f0-8000-97669e000eb8"

document_packet_id
string
required

The document packet the run executed on (hyphenated UUID).

Example:

"069dcc2c-e14c-7606-8000-2ee4fb17b4e1"

status
enum<string>
required

Execution status. Non-terminal: queued, in_progress. Terminal: processed (success), error, cancelled.

Available options:
queued,
in_progress,
processed,
error,
cancelled
Example:

"processed"

created_at
string<date-time> | null

Timestamp when the run was triggered (ISO 8601).

updated_at
string<date-time> | null

Timestamp of the run's last status change (ISO 8601).

results
ResultsResponseV3 · object | null

Extraction results envelope; null until status is processed.