{"componentChunkName":"component---src-templates-simple-markdown-js","path":"/docs/ai/document-ai/processing-documents/","matchPath":"","result":{"data":{"markdownRemark":{"html":"

How Processing Works

\n

Document processing is asynchronous. Upload and reprocessing requests return after a run is accepted; processing continues independently.

\n

Documents, runs, and results

\n

Document AI uses three related resources:

\n\n

Every new processing attempt creates a new run. Prior runs and results remain available for comparison and audit.

\n

Configuration snapshot

\n

When a run is created, its selected processing configuration is captured as a complete snapshot. Later edits to a saved configuration do not change an existing run.

\n

Learn how to select the appropriate settings in Choosing a Configuration.

\n

Status lifecycle

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
StatusMeaningWhat to do
pendingThe run was accepted and is waiting to start.Continue polling or wait for an event.
processingWork is in progress.Display progress and continue waiting.
completedProcessing finished successfully.Retrieve and use the results.
failedProcessing could not complete.Inspect error, correct the input or configuration, then create a new run if appropriate.
skippedProcessing was not applicable to the stored file.Review the skip reason and file eligibility.
oversizedThe file exceeds a processing limit but may still be stored.Review the reported reason and current file-type limits.
\n

Treat completed, failed, skipped, and oversized as terminal for that run.

\n\n

Monitor a run

\n

Use GET /document-store/runs/{id} to retrieve a run.

\n

The response includes:

\n\n

Review processing activity

\n

Use GET /document-store/activity for customer-visible progress and troubleshooting entries.

\n

Filter by document_id or run_id. Entries include the processing step, status, message, and creation time. Results default to 25 per page and support up to 100.

\n

Polling guidance

\n\n

When a run completes, continue to Reading Results. To start another attempt or review history, see Runs and Reprocessing.

","headings":[{"value":"How Processing Works","depth":1},{"value":"Documents, runs, and results","depth":2},{"value":"Configuration snapshot","depth":2},{"value":"Status lifecycle","depth":2},{"value":"Monitor a run","depth":2},{"value":"Review processing activity","depth":2},{"value":"Polling guidance","depth":2}]},"contentItem":{"data":{"lastModified":"2026-07-17T16:00:10.000Z","enableToc":null,"disableLastModified":null,"tocMaxDepth":null,"requestLogin":false}},"siteConfig":{"enableToc":true,"disableLastModified":false,"tocMaxDepth":4}},"pageContext":{"matchPath":"","id":"d3dc74ca-8c04-5259-ae0f-9a73895fb90b__redocly content/docs/ai/document-ai/processing-documents/","seo":{"title":"How Processing Works","description":null,"image":"","keywords":null,"jsonLd":null,"lang":null,"siteUrl":null},"pageId":"docs/ai/document-ai/processing-documents.md","pageBaseUrl":"/docs/ai/document-ai/processing-documents","type":"markdown","toc":{"enable":true,"maxDepth":4,"headings":[{"depth":1,"value":"How Processing Works","id":"how-processing-works"},{"depth":2,"value":"Documents, runs, and results","id":"documents-runs-and-results"},{"depth":2,"value":"Configuration snapshot","id":"configuration-snapshot"},{"depth":2,"value":"Status lifecycle","id":"status-lifecycle"},{"depth":2,"value":"Monitor a run","id":"monitor-a-run"},{"depth":2,"value":"Review processing activity","id":"review-processing-activity"},{"depth":2,"value":"Polling guidance","id":"polling-guidance"}]},"data":{"title":"How Processing Works"},"catalogInfo":null,"link":"/docs/ai/document-ai/processing-documents/","sidebarName":"developerPortal","isLanding":false,"showPrevButton":null,"showNextButton":null,"apiVersions":null,"apiVersionId":null,"isDefaultApiVersion":null}},"staticQueryHashes":["1123603147","1302185487","1344209882","1398840060","1520077861","1975142765","2667623876","2950305614","3240152602","3743992808","561138138"]}