POST /bulk/multiupload — Batch Document Upload

Submit a list of document URLs to Atlas for asynchronous bulk OCR extraction. Atlas queues each document, processes it, and stores the results against the returned batch_id. You then use that batch_id with GET /bulk/extracts to retrieve the extracted data once processing is complete.

The Bulk Service does not support callbacks. You must poll GET /bulk/extracts to retrieve results.

Endpoint

POST /bulk/multiupload

Authentication

This endpoint requires a JWT token obtained from POST /bulk/authtoken. Pass it in the Token request header.

Request headers

string

required

JWT access token issued by POST /bulk/authtoken.

Request body

string

required

Product type identifier for this batch. Example: "POC_CDL".

array

required

List of document file objects to process. Each element must include both file_url and document_id.

Show file_urls item properties

string

required

A publicly accessible (or pre-signed) URL pointing to the document file. Accepted formats include JPEG, PNG, and PDF.

string

required

Your own identifier for this document. Atlas echoes it back in the extracts response so you can map results to your records.

Response

A 201 Created response contains an array — one entry per uploaded document — each sharing the same batch_id.

string

The batch identifier assigned to all documents in this upload (e.g., "BATCH-30732-SIYKJ-20251121113228"). Use this value when polling GET /bulk/extracts.

string

Echo of the document_id you provided for this file.

string

Internal UUID Atlas assigned to the individual file. Useful for support queries.

Error responses

Status	Meaning
`400`	`Bad Request` — one or more required parameters are missing or malformed.
`401`	`Invalid token` — the token is expired, revoked, or does not match any active session.

Examples

curl --request POST \
  --url https://api.helloatlas.in/v1/bulk/multiupload \
  --header 'Content-Type: application/json' \
  --header 'Token: <YOUR_JWT_TOKEN>' \
  --data '{
    "product_type": "POC_CDL",
    "file_urls": [
      {
        "file_url": "https://files.s3.ap-south-1.amazonaws.com/uploads/files/sample1.jpg",
        "document_id": "1"
      },
      {
        "file_url": "https://files.s3.ap-south-1.amazonaws.com/uploads/files/sample2.jpg",
        "document_id": "2"
      },
      {
        "file_url": "https://files.s3.ap-south-1.amazonaws.com/uploads/files/sample3.jpg",
        "document_id": "3"
      }
    ]
  }'

[
  {
    "batch_id": "BATCH-30732-SIYKJ-20251121113228",
    "document_id": "1",
    "file_uuid": "03f03421-c933-46fc-a30c-ffb3ea8afd1d"
  },
  {
    "batch_id": "BATCH-30732-SIYKJ-20251121113228",
    "document_id": "2",
    "file_uuid": "03f03422-c933-46fc-a30c-ffb3ea8afd1d"
  },
  {
    "batch_id": "BATCH-30732-SIYKJ-20251121113228",
    "document_id": "3",
    "file_uuid": "03f03423-c933-46fc-a30c-ffb3ea8afd1d"
  }
]

Save the batch_id immediately — all documents in the same upload share it, and you need it to fetch results.

Authentication

IDP Extraction

Document Verification

Chat Based Onboarding

Bulk Service

Address Match

POST /bulk/multiupload — Batch Document Upload

Endpoint

Authentication

Request headers

Request body

Response

Error responses

Examples

​Endpoint

​Authentication

​Request headers

​Request body

​Response

​Error responses

​Examples

Endpoint

Authentication

Request headers

Request body

Response

Error responses

Examples