Skip to main content
This API allows you to upload multiple document URLs for processing in a single request. Atlas begins extraction and classification asynchronously after upload. Each document must be accessible via a public or pre-signed URL.

​
Endpoint

POST /v2/verification/multiupload

​
Request headers

​
Token
string
required
JWT access token used for authentication.

​
Request body

​
flow_id
string
required
Unique identifier for the verification flow. Obtained from the flow initialization API.
​
file_urls
array
required
List of documents to be processed.
​
file_urls[].file_url
string
required
Pre-signed or publicly accessible URL of the document.
​
file_urls[].document_id
string
required
Your internal identifier for the document. This is echoed back in responses.
​
file_urls[].submission_mode
string
Indicates how the document was submitted (for example: upload, camera, whatsapp). Optional but useful for analytics and audit.

​
Response

​
file_uuid
string
Unique identifier generated by Atlas for each uploaded document.
​
batch_id
string
Batch identifier grouping all documents uploaded in this request. Use this to poll extraction results.
​
document_id
string
Echo of your provided document identifier.
​
file_url
string
URL of the uploaded file.

​
Example

curl --request POST \
  --url https://api.helloatlas.in/v2/verification/multiupload \
  --header "Token: <TOKEN>" \
  --header "Content-Type: application/json" \
  --data '{
    "flow_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "file_urls": [
      {
        "file_url": "https://your-bucket.s3.ap-south-1.amazonaws.com/pan.jpg",
        "document_id": "doc_1",
        "submission_mode": "upload"
      },
      {
        "file_url": "https://your-bucket.s3.ap-south-1.amazonaws.com/aadhaar.jpg",
        "document_id": "doc_2",
        "submission_mode": "camera"
      }
    ]
  }'

​
Error responses

StatusMeaning
400Missing or invalid required parameters (for example, missing flow_id).
422Upstream authentication or processing failure (for example, Lentra Auth API failure).

​
Notes

Ensure all file_url values are accessible from Atlas servers. Expired or private URLs will result in processing failures.