Document Authentication Statuses

Integrations guide

This page sets out possible statuses, explanatory status codes, CDD Report availability, and risk codes for Document Authentication.

Note
Note
In addition to checking the status in webhook notifications, you can check the status of a specific Document Authentication case any time via a Get Document Authentication status request.


Statuses

Possible statuses include:

StatusGuidance
newDescription: The case is successfully created.

Action: Wait for the next status.
pendingDescription: We are validating the data.

Action: Wait for the next status.

Status code: 1000
inconsistent_dataDescription: We found inconsistent data.

Action: Retry.

Status codes: 3000 series
invalid_dataDescription: We found invalid data.

Action: Retry.

Status codes: 3000 series
completedDescription: We have processed the case.
For our recommendation to accept or reject it, see the risk code.

Action: Download the CDD Report.

Status codes: 40005000 series

Risk codes: 200 or 500


Status flow diagram

The pathways for statuses are as follows:

Document Authentication status flow

Document Authentication status flow



Risk codes

Possible risk codes include:

Risk codeRisk score
200completed_low_risk
500completed_unacceptable_risk


Status codes

Statuses can be accompanied by one or multiple of the following status codes:

1000: Data validation

This status code accompanies pending status:

Status codeGuidance
1000The data has been successfully validated.

Action: Wait for the next status notification.

3000: Sendbacks

This series can accompany inconsistent_data or invalid_data status and includes:

Status codeGuidance
3105Not the same person

Action: Create a new case.
3500No geolocation provided

Action: Create a new case with the client's geolocation.
3510Geolocation is in a prohibited country

Action: Create a new case with the geolocation in a supported country.
3540Device metadata inconsistent

Action: Create a new case.
3600Document video too bright

Action: Upload a new video.
3601Document video too dark

Action: Upload a new video.
3602Document video too blurry

Action: Upload a new video.
3603Document video poor quality

Action: Upload a new video.
3610Inadequate document video

Action: Upload a new video.
3620Liveness features not visible in document video

Action: Upload a new video.

4000: Rejections

Fatal
The client can't retry.

This series accompanies completed status and includes:

Status codeDescription
4145Geolocation is prohibited
4190Other rejected
4192Video rejected
4200Assisted selfie
4202Assisted video

5000: Fraud

Fatal
The client can't retry.

This series accompanies completed status and includes:

Status codeDescription
5200Selfie tampering
5201Selfie tampering - Photo of a photo
5202Selfie tampering - Different person
5210Biometric verification
5600Video tampering
5601Different person in video
5610Video other fraud
5900Other fraud

Top of page