Process Your First Freight Document
Create an API key, submit a PDF, check document status, and download an Excel result with Manifest AI API v1.
Create a scoped API key, submit one PDF with an Idempotency-Key, store the returned document ID, and poll its status until it becomes completed or failed.
Before you begin
You need a Scale or Custom workspace and a server-side environment.
- Create an API key with documents:write and documents:read scopes.
- Add exports:read if the integration downloads Excel files.
- Store the key in a secret manager or server environment variable.
- Use a synthetic or authorized PDF for the first request.
Submit the PDF
Send multipart form data and a stable idempotency key.
cURL
curl -X POST "https://manifestai.io/api/v1/documents" \
-H "Authorization: Bearer $MANIFEST_AI_API_KEY" \
-H "Idempotency-Key: shipment-1042-commercial-invoice" \
-F "file=@commercial-invoice.pdf" \
-F "profile_id=YOUR_PROFILE_ID"Check status
The document resource is the source of truth for progress and retained results.
- queued or running: continue waiting.
- paused: resume when ready.
- completed: consume data or request the Excel export.
- failed or cancelled: inspect the problem information and decide whether to submit again.
cURL
curl "https://manifestai.io/api/v1/documents/DOCUMENT_ID" \
-H "Authorization: Bearer $MANIFEST_AI_API_KEY"Move to production
Add webhooks, retries, timeouts, and request tracing before processing customer traffic.
- Log X-Request-Id from every response.
- Back off after HTTP 429 and follow Retry-After.
- Treat webhook delivery as at-least-once.
- Test duplicate, cancellation, deletion, and expired-result paths.