Skip to main content
GET
Returns the results of every configured workflow node in a flat dictionary keyed by node category. The categories are parse, extraction, classification, splitter and edit. The collection_id in the URL is the id that POST /v2/workflows/{workflow_id}/files/ or POST /v2/workflows/{workflow_id}/run/ returned. The endpoint returns:
  • 200 OK with the results once processing succeeds.
  • 412 Precondition Failed while processing is in progress. Retry it.
  • 422 Unprocessable Entity once the extraction is terminal, failed or cancelled. Read error_code to tell them apart.
In production, use webhooks instead of polling. A webhook delivers results at once and consumes no rate limit.

Polling Example with Backoff

Validation Verdicts (extractions[].validations[])

A workflow with a Validate node returns its verdicts inside each extractions[] entry, beside the fields the rules judged. Each entry covers one rule and carries rule_id, severity, status, detail, and the compared_values the rule looked at. status is pass, fail or inconclusive. In a split workflow, every subdocument carries its own verdicts. The key is always present, and is [] when the workflow has no validate node. Response Formats documents it field by field.

Filled Forms (edits[])

A workflow with an Edit node also returns edits[], one entry per file the node processed. Each entry carries 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. Response Formats documents it field by field. fields[].confidence is a raw, uncalibrated 0-100 match score for pairing a filling instruction with a field. It grades how surely the instruction addresses that field, not whether the written value is correct, and it is not a probability. A field with state: "prefilled" is never overwritten, so it always reads back with value: null and confidence: null.
download_url is a presigned link, valid for 15 minutes from the moment the API built the response. Every read of this endpoint mints a fresh one. Download the PDF on receipt, or re-read the endpoint for a new link. Never store the URL.
The extraction and parse keys are always present in a success response. Each is explicitly null when its node did not run. See Response Formats for the canonical shape, documented field by field.

Authorizations

Authorization
string
header
required

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

Path Parameters

workflow_id
string
required
collection_id
string
required

Response

Successful Response

Canonical response shape for the file-collection results endpoint.

Returned with HTTP 200 once processing completes. Returns 412 while processing is in progress; poll until 200, or use webhooks.

collection_id
string
required

The file collection's UUID. Same value as the id returned by POST /v2/workflows/{wid}/run/. Also emitted as document_packet_id — same value, v3 canonical name.

document_packet_id
string
default:""
required

The document packet's UUID — v3 canonical name for collection_id. Same value; both fields are always present.

verification_url
string | null

Link to the AnyFormat dashboard for human review of this collection's results. null if the dashboard URL cannot be constructed (e.g. no files in the collection, or the deployment has no frontend URL configured).

parse
ParseResult · object | null

Parse-node output (rendered markdown). null when the workflow has no parse node. Always present in the response.

classifications
ClassificationResult · object[]

Per-classifier-node verdicts. Empty when the workflow has no classifier.

splits
SplitResult · object[]

Splitter output: category-level geometry with optional partitions. Empty when the workflow has no splitter.

extractions
Extraction · object[]

Flat list of extraction datapoints. Linear workflows produce one entry with split_name=null and partition=null. Split workflows produce one entry per (split, partition). Empty when no extraction has run yet.

edits
Edit · object[]

Filled-form output, one entry per file an edit node processed. Empty when the workflow has no edit node.

extraction
Extraction · object | null
deprecated

Deprecated — use extractions instead. Extracted fields keyed by field name, populated only for linear workflows (single extract node, no splitter). null for split workflows; read extractions[] instead.