POST /verification/multiupload — Upload Documents

Request body

string

required

Unique identifier for the verification flow. Obtained from the flow initialization API.

array

required

List of documents to be processed.

string

required

Pre-signed or publicly accessible URL of the document.

string

required

Your internal identifier for the document. This is echoed back in responses.

string

Indicates how the document was submitted (for example: upload, camera, whatsapp). Optional but useful for analytics and audit.

Response

string

Unique identifier generated by Atlas for each uploaded document.

string

Batch identifier grouping all documents uploaded in this request. Use this to poll extraction results.

string

Echo of your provided document identifier.

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"
      }
    ]
  }'

[
  {
    "file_url": "https://altas-integration-docs.s3.ap-south-1.amazonaws.com/Image_20250623_181139_394.jpeg",
    "file_uuid": "03f0341d-c933-46fc-a30c-ffb3ea8afd1d",
    "batch_id": "BATCH-55193-DRTYJ-20250811084615",
    "document_id": "1234"
  }
]

Error responses

Status	Meaning
`400`	`batch_id is required` — the batch identifier was not provided in the request.
`401`	`Invalid or expired token` — the authentication token is missing, invalid, or expired.

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

Authentication

IDP Extraction

Document Verification

Chat Based Onboarding

Bulk Service

Address Match

POST /verification/multiupload — Upload Documents

Endpoint

Request headers

Request body

Response

Example

Error responses

​Endpoint

​Request headers

​Request body

​Response

​Example

​Error responses

Endpoint

Request headers

Request body

Response

Example

Error responses