Skip to main content
POST
/
api
/
v2
/
classify
/
sync
curl --request POST \
  --url https://extraction-api.nanonets.com/api/v2/classify/sync \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "input": "file://a1b2c3d4-e5f6-7890-abcd-ef1234567890"
}
'
{
  "success": true,
  "message": "Document classified successfully",
  "status": "completed",
  "result": {
    "filename": "invoice.pdf",
    "total_pages": 3,
    "mode": "document",
    "document_category": "Invoice",
    "confidence": 92.5,
    "reasoning": "Page 1: Contains invoice header with vendor details; Page 2: Itemized list of products with pricing"
  },
  "processing_time": 1.5,
  "filename": "invoice.pdf"
}

Authorizations

Authorization
string
header
required

API key as Bearer token: Authorization: Bearer YOUR_API_KEY

Body

application/json
input
required

file://<uuid> URI or public URL. Async accepts a list (max 50).

config_id
string

config://<uuid> of a saved classify config

classification_config
object

Response

Classification completed

success
boolean
required
message
string
required
record_id
string
file_id
string
config_id
string
status
enum<string>
Available options:
completed,
processing,
failed
result
object

Classification result (shape depends on mode)

processing_time
number

Time in seconds

filename
string
file_size
integer

Size in bytes