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