GET /status — Check Verification Flow Status

After uploading documents with POST /multiupload, poll this endpoint to track progress through each stage of the pipeline. When master_status reaches SUCCESS or FAILED, the flow is complete and you can call GET /extracts to retrieve results.

Endpoint

GET /verification/status

Request headers

string

required

JWT access token obtained from POST /authtoken.

Query parameters

string

required

The UUID returned by POST /flow/init.

Response

string

Reflects whether Atlas has successfully ingested all uploaded files.Possible values: NOT_STARTED | IN_PROGRESS | SUCCESS | FAILED

string

Reflects the OCR extraction stage for each document.Possible values: NOT_STARTED | IN_PROGRESS | SUCCESS | FAILED | PENDING

string

Reflects pairwise cross-document validation (note: field name is spelled crossheck_status in the API response).Possible values: NOT_STARTED | PENDING | COMPLETED

string

The overall status of the flow. This is the primary field to watch when polling.Possible values: NOT_STARTED | IN_PROGRESS | SUCCESS | FAILED

Example

curl --request GET \
  --url "https://api.helloatlas.in/v3/verification/status?flow_uuid=ec57821d-d766-4e24-81ef-a2768094511b" \
  --header "Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."

{
  "upload_status": "SUCCESS",
  "processing_status": "IN_PROGRESS",
  "crossheck_status": "PENDING",
  "master_status": "IN_PROGRESS"
}

{
  "upload_status": "SUCCESS",
  "processing_status": "SUCCESS",
  "crossheck_status": "COMPLETED",
  "master_status": "SUCCESS"
}

Error responses

Status	Meaning
`400`	`Missing required ['flow_uuid'] parameters` — the query parameter was not included.
`401`	`Invalid token` — the `Token` header is missing, expired, or invalid.
`409`	`Flow not found` — no flow exists for the provided `flow_uuid`.

Poll this endpoint until master_status is SUCCESS or FAILED. A reasonable polling interval is every 5–10 seconds. Once master_status is SUCCESS, call GET /extracts to retrieve the full OCR and cross-check results.

Authentication

IDP Extraction

Document Verification

Chat Based Onboarding

Bulk Service

Address Match

GET /status — Check Verification Flow Status

Endpoint

Request headers

Query parameters

Response

Example

Error responses

​Endpoint

​Request headers

​Query parameters

​Response

​Example

​Error responses

Endpoint

Request headers

Query parameters

Response

Example

Error responses