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.
`verified`	The identity has been successfully verified.	Proceed with accepting the request that required identity verification.
`failed`	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 failed, the status codes can help diagnose the issue. A verification may include multiple reason codes.

STATUS: inconclusive

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

Code	Type	Description
IDVV_1101	Engagement issue	The individual never started the flow.
IDVV_1111	Engagement issue	The individual explicitly stated that they wanted to perform the identity verification later by clicking on the dedicated button.
IDVV_1112	Engagement issue	The individual explicitly stated that they did not have their document with them by clicking on the dedicated button.
IDVV_1113	Engagement issue	The individual did not give access to the camera despite the dedicated instructions.
IDVV_1121	Engagement issue	The individual left the process before the capture phase and the verification URL expired (after 15 minutes).
IDVV_1199	Engagement issue	Verification expired (after 7 days) before the user completed the flow.
IDVV_3001	Engagement issue	The individual explicitly refused to do the verification process by clicking on the dedicated button.
IDVV_1201	Technical issue	The individual did not have a sufficient connexion to perform the capture.
IDVV_1202	Technical issue	The individual’s browser was not suitable for video streaming.
IDVV_1203	Technical issue	The individual’s device did not have any camera.
IDVV_1314	Document capture issue	The individual failed to meet the document challenge and the verification expired.
IDVV_1413	Face capture issue	The individual failed to meet the face challenge and the verification expired.

STATUS: failed

Code	Type	Description
IDVV_1201	Technical issue	The individual did not have a sufficient connexion to perform the capture.
IDVV_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).
IDVV_1302	Document capture issue	The individual performed the document capture under poor lighting conditions.
IDVV_1310	Document capture issue	The individual has not captured the front of the document.
IDVV_1311	Document capture issue	The individual has not captured the back of the document.
IDVV_1312	Document capture issue	The individual hides part of the document.
IDVV_1313	Document capture issue	The individual did not present a dynamic view of the document.
IDVV_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).
IDVV_1402	Face capture issue	The individual performed their identity verification under poor lighting conditions.
IDVV_1410	Face capture issue	The individual has not presented a face.
IDVV_1411	Face capture issue	The individual did not show the full front view of their face.
IDVV_1412	Face capture issue	The individual did not move to prove the liveness.
IDVV_1901	Other issue	An internal error prevents us from completing the verification, we do our best to reduce the occurrence of this case.
IDVV_1911	Other issue	The received videos cannot be played.
IDVV_2101	Document issue	The individual presented an expired document.
IDVV_2102	Document issue	The individual presented a document type that is not accepted.
IDVV_2103	Document issue	The individual submitted a damaged document.
IDVV_2201	Copy issue	The individual presented a photocopy of the document.
IDVV_2202	Copy issue	The individual presented the document on a screen.
IDVV_2301	Identity fraud	The individual submitted a counterfeit or falsified document.
IDVV_2302	Identity fraud	The individual presented a document reported as stolen or lost.
IDVV_2303	Identity fraud	The individual presented the front and back of two different documents.
IDVV_2304	Identity fraud	The individual does not match the photograph of the document.
IDVV_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.
IDVV_2306	Identity fraud	The individual altered their appearance.
IDVV_2307	Identity fraud	The individual digitally altered the videos.
IDVV_2311	Identity fraud	The individual of the face authentication is not the one who performed the identity verification.
IDVV_2401	Consistency issue	The individual's identity does not match the declared information.
IDVV_2402	Suspicious behavior	The individual used a device that has been technically altered.
IDVV_2403	Suspicious behavior	The individual seems to have performed the capture under duress.