Skip to main content
After initialising a flow with POST /flow/init, submit all document URLs in a single call to this endpoint. Atlas will download each file, run OCR extraction, and queue cross-document validation automatically.

​
Endpoint

POST /v3/verification/multiupload

​
Request headers

​
Token
string
required
JWT access token obtained from POST /authtoken.

​
Request body

​
flow_uuid
string
required
The UUID returned by POST /flow/init. Ties these uploads to the correct verification session.
​
file_urls
array
required
An array of file objects. You may include multiple documents in a single request.

​
Response

The response is an array with one entry per uploaded file.
​
file_uuid
string
Atlas’s UUID for this specific file. Unique across all uploads.
​
batch_id
string
A batch identifier grouping all files submitted in this request (for example, BATCH-30732-SIYKJ-20251121113228).
​
document_id
string
The document_id you provided during upload, echoed back for easy correlation.

​
Example

curl --request POST \
  --url https://api.helloatlas.in/v3/verification/multiupload \
  --header "Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..." \
  --header "Content-Type: application/json" \
  --data '{
    "flow_uuid": "LOS-17cab13b-f437-49bc-9c08-55319b88b0eb",
    "file_urls": [
      {
        "file_url": "https://files.s3.ap-south-1.amazonaws.com/uploads/invoice.jpg",
        "document_id": "1"
      },
      {
        "file_url": "https://files.s3.ap-south-1.amazonaws.com/uploads/delivery-order.jpg",
        "document_id": "2"
      },
      {
        "file_url": "https://files.s3.ap-south-1.amazonaws.com/uploads/imei-closeup.jpg",
        "document_id": "3"
      }
    ]
  }'

​
Error responses

StatusMeaning
400Missing or empty required parameters: ['flow_uuid'] — a required field is absent from the request body.
422External service failure (for example, Atlas could not reach the authentication URL you configured).
The document_id field is your primary way to match Atlas extraction results back to your own documents. Choose a value that is unique within the flow and meaningful in your system (for example, a database record ID).