Upload

Upload endpoint

Submit documents by multipart file upload or remote URL. Returns a jobId for polling.

Last updated: April 2026

Endpoint

HTTP

POST https://api.number7ai.com/api/v1/upload

Query param	Required	Description
document.type	Yes	Document class — see supported types below
document.version	Yes	Use `v1`

Supported document types

document.type	Use for
invoice	GST invoices, supplier invoices, purchase invoices
grn	Goods receipt notes
bank_statement	Bank statement PDFs (tabular format)
aadhar_card	Aadhaar card (front and back)
pan_card	PAN card

Multipart file upload

Send the file as multipart/form-data with these fields:

Field	Type	Description
file	File	The document binary
fileName	string	Original filename including extension
fileType	string	MIME type, e.g. `application/pdf`

cURL

curl -X POST \
  "https://api.number7ai.com/api/v1/upload?document.type=invoice&document.version=v1" \
  -H "Authorization: Bearer $API_KEY" \
  -F "file=@invoice.pdf" \
  -F "fileName=invoice.pdf" \
  -F "fileType=application/pdf"

Success response

JSON

{
  "success": true,
  "data": {
    "jobId": "job_abc123",
    "fileStatus": "uploading"
  }
}

Use the jobId to poll GET /results/:jobId until fileStatus reaches done or failed.