Skip to main content
POST
https://agent.usedari.com
/
documents
/
upload
curl -X POST https://agent.usedari.com/documents/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@documents.zip"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending"
}
Uploads a zip file containing PDF documents. Returns a bundle ID immediately while processing happens in the background. Each PDF is parsed via OCR and structured data is extracted automatically. Use the returned bundle ID with Start Job to auto-fill form data from the extracted document content.

​
Headers

​
X-API-Key
string
required
Organization API key
​
Content-Type
string
required
Must be multipart/form-data

​
Request Body

​
file
file
required
Zip file containing PDF documents (.zip, max 50MB, max 20 PDFs)

​
Response Fields

​
id
string
UUID of the created document bundle. Use this to poll status or pass to Start Job.
​
status
string
Initial status, always pending. Transitions to processing, then completed or failed.
curl -X POST https://agent.usedari.com/documents/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "file=@documents.zip"

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "pending"
}

​
Usage Notes

  • Processing typically takes 10-30 seconds depending on the number and size of PDFs.
  • Use Get Document Bundle to poll for completion.
  • When starting a job with document_bundle_id, the server will automatically wait for processing to finish (up to 60 seconds).
  • Hidden files and macOS metadata (__MACOSX) are automatically filtered out.