Skip to main content
POST
/
api
/
v1
/
classify
/
batch
Batch Classification (Async)
curl --request POST \
  --url https://extraction-api.nanonets.com/api/v1/classify/batch \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'files=<string>' \
  --form 'categories=[{"name": "Invoice"}, {"name": "Contract"}, {"name": "Receipt"}]' \
  --form files.items='@example-file'
{
  "success": true,
  "message": "<string>",
  "batch_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "total_files": 123,
  "successful_files": 123,
  "failed_files": 123,
  "results": [
    {
      "filename": "<string>",
      "total_pages": 123,
      "pages": [
        {
          "page_number": 2,
          "category": "<string>",
          "confidence": 50,
          "reasoning": "<string>",
          "identified_category": "<string>"
        }
      ],
      "file_id": "<string>",
      "processing_time": 123,
      "error": "<string>"
    }
  ]
}

Authorizations

Authorization
string
header
required

API key as Bearer token: Authorization: Bearer YOUR_API_KEY

Body

multipart/form-data
files
file[]
required

Files to classify (max 50)

Maximum array length: 50
categories
string
required

JSON array of category objects (max 50 categories)

Example:

"[{\"name\": \"Invoice\"}, {\"name\": \"Contract\"}, {\"name\": \"Receipt\"}]"

Response

Batch queued

success
boolean
required
message
string
required
batch_id
string<uuid>
required
total_files
integer
required
successful_files
integer
required
failed_files
integer
required
results
object[]
required