Classify in bulk

Submit several documents for classification in one request.

POST /classify/bulk queues several files for classification.

Requires the X-Api-Key header.

Request body

Send application/json using ClassifyBulkRequest.

Property	Type	Description
context	array | null	Per-file context. The length must match files.
custom_document_types	array | null	Custom types for every file.
custom_document_types_url	string | null	URL to custom types. Merges with custom_document_types.
entities	object | null	Entity ID-to-name mapping for Excel workbooks.
files	array<ClassifyBulkRequestFile>	Files to classify.
metadata	array | null	Per-file metadata. The length must match files.
model	string | null	Model for all files. Defaults to gemini-3.
use_custom_types_only	boolean | null	Limits results to custom types for all files.

File object

ClassifyBulkRequestFile

Property	Type	Description
content	string	Base64-encoded file content.
file_url	string	Public URL to the file.

Responses

Status	Description	Schema
200	OK	ClassifyBulkResponse
400	Bad Request	ValidationError
401	The API key is missing or invalid.

Example

curl -X POST "https://<api-host>/classify/bulk" \
  -H "X-Api-Key: $DOCAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
         "files": [
           { "file_url": "https://example.com/doc-1.pdf" },
           { "file_url": "https://example.com/doc-2.pdf" }
         ]
       }'