Document Status and Results
Track Manifest AI document processing states and consume retained structured freight-document results.
GET /api/v1/documents/{id} returns the current lifecycle state, progress, timestamps, links, and—after completion—the retained structured result available to that workspace.
Lifecycle states
Treat terminal and non-terminal states differently.
- queued, running, retrying
- Processing is active or waiting for available capacity.
- pausing, paused
- A pause was requested or the job is safely checkpointed.
- cancelling, cancelled
- Cancellation is underway or complete.
- completed
- Structured output is available, subject to retention.
- failed
- Processing ended safely; inspect error fields and request ID.
Polling
Poll with backoff instead of holding the submission request open.
- Start at 2–5 seconds for interactive workflows.
- Increase the interval for long documents.
- Stop at terminal status.
- Prefer signed webhooks for background integrations.
cURL
curl "https://manifestai.io/api/v1/documents/DOCUMENT_ID" \
-H "Authorization: Bearer $MANIFEST_AI_API_KEY"Retained data
Results remain available for the configured retention window unless deleted earlier.
The resource reports result_expires_at and data_deleted. Build integrations to copy required business data before expiry and tolerate a deleted or expired result.