Verification statuses

The identity verification lifecycle consists of the following stages:

Status	Description	Recommended action
`pending`	The video identity verification has been been initiated.	Share the `verification_url` with the individual whose identity needs to be verified. Then wait for the `status` to change.
`inconclusive`	The verification could not be completed. For more details, refer to the status codes section below.	Initiate a retry by creating a new video identity verification.
`approved`	The identity has been successfully verified.	Proceed with accepting the request that required identity verification.
`declined`	The identity verification failed due to certain issues (refer to the status codes section below).	Reject the request that required identity verification. If needed, initiate a new video identity verification.

Status codes

If the verification is inconclusive or declined, the status codes can help diagnose the issue. A verification may include multiple reason codes.

STATUS: inconclusive

ℹ️
Unlike declined or approved statuses, an inconclusive verification does not incur a charge to the client.

Code	Type	Description
1101	Engagement issue	The individual never started the flow.
1111	Engagement issue	The individual explicitly stated that they wanted to perform the identity verification later by clicking on the dedicated button.
1112	Engagement issue	The individual explicitly stated that they did not have their document with them by clicking on the dedicated button.
1113	Engagement issue	The individual did not give access to the camera despite the dedicated instructions.
1121	Engagement issue	The individual left the process before the capture phase and the verification URL expired (after 15 minutes).
3001	Engagement issue	The individual explicitly refused to do the verification process by clicking on the dedicated button.
1201	Technical issue	The individual did not have a sufficient connexion to perform the capture.
1202	Technical issue	The individual’s browser was not suitable for video streaming.
1203	Technical issue	The individual’s device did not have any camera.
1204	Technical issue	The individual switched tabs/application while performing the identity verification.
1205	Technical issue	The individual did not receive the SMS they requested to start the identity verification.
1301	Document capture issue	The individual document video is too blurry (mostly due to too much movement but if this error persists the camera quality might be at fault).
1302	Document capture issue	The individual performed the document capture under poor lighting conditions.
1310	Document capture issue	The individual has not captured the front of the document.
1311	Document capture issue	The individual has not captured the back of the document.
1312	Document capture issue	The individual hides part of the document.
1313	Document capture issue	The individual did not present a dynamic view of the document.
1314	Document capture issue	The individual failed to meet the document challenge and the verification expired.
1315	Document capture issue	The barcode of the document is unreadable.
1401	Face capture issue	The individual’s video of their face is too blurry (mostly due to too much movement but if this error persists the camera quality might be at fault).
1402	Face capture issue	The individual performed their identity verification under poor lighting conditions.
1410	Face capture issue	The individual has not presented a face.
1411	Face capture issue	The individual did not show the full front view of their face.
1412	Face capture issue	The individual did not move to prove the liveness.
1413	Face capture issue	The individual failed to meet the face challenge and the verification expired.
1414	Face capture issue	The individual also captured another person face.
1901	Other issue	An internal error prevents us from completing the verification, we do our best to reduce the occurrence of this case.
1911	Other issue	The received videos cannot be played.

STATUS: declined

Code	Type	Description
2101	Document issue	The individual presented an expired document.
2102	Document issue	The individual presented a document type that is not accepted.
2103	Document issue	The individual submitted a damaged document.
2201	Copy issue	The individual presented a photocopy of the document.
2202	Copy issue	The individual presented the document on a screen.
2301	Identity fraud	The individual submitted a counterfeit or falsified document.
2302	Identity fraud	The individual presented a document reported as stolen or lost.
2303	Identity fraud	The individual presented the front and back of two different documents.
2304	Identity fraud	The individual does not match the photograph of the document.
2305	Identity fraud	The individual has presented a photography or a video of someone else's face on a screen or on a physical medium.
2306	Identity fraud	The individual altered their appearance.
2307	Identity fraud	The individual digitally altered the videos.
2311	Identity fraud	The individual of the face authentication is not the one who performed the identity verification.
2401	Consistency issue	The individual's identity does not match the declared information.
2402	Suspicious behavior	The individual used a device that has been technically altered.
2403	Suspicious behavior	The individual seems to have performed the capture under duress.