Identity Verification Statuses
Integration Guides
This page sets out possible statuses, explanatory status codes, CDD Report availability, and risk codes for Identity Verification.
Note
In addition to checking the status in webhook notifications, you can check the status of a specific Identity Verification case at any time using the Get case status endpoint.
flowVariantis returned when the workflow offers both eID and verification with a physical ID document. When the workflow does not offer both, the property is absent.eIDVerificationmeans the client completed eID.DocumentVerificationmeans the client completed verification with a physical ID document. The webhook and Get case status return the same value. PDF and XML reports do not includeflowVariant.
Statuses
Possible notifications include:
| Status | Guidance |
|---|---|
new | Description: The workflow is successfully created. Action: • SDK integration: Wait for the next status. • API integration: Upload the identity data and identity files. |
pending | Description: We are validating the data. Action: Wait for the next status. Status code: 1000 |
invalid_data | Description: We found invalid or missing data. Action: Create a new workflow. Status codes: 1001 – 1999 |
inconsistent_data | Description: We found inconsistent data. Action: Create a new workflow. Status codes: 2000 – 3000 series |
completed | Description: We have processed the case. For our recommendation to accept or reject the client, see the risk code. Risk codes: • 200 – 500: 100 series status codes • 500: 4000 – 5000 series status codes Action: Download the CDD Report zipfile. |
Status flow diagram
The pathways for statuses are as follows:
Identity Verification status flow
Risk codes
Possible risk codes include:
| Risk code | Risk score |
|---|---|
200 | completed_low_risk |
300 | completed_medium_risk |
400 | completed_high_risk |
500 | completed_unacceptable_risk |
Status codes
Statuses can be accompanied by one or multiple of the following status codes:
Updated 16 days ago