Identities codes
Beta

Last updated: May 28, 2025

Identities checks can have the following statuses, attempt statuses, and response codes.

Information

When we add new response codes, we always ensure backward compatibility. However, we recommend basing your business rules on the status, and then using response codes as additional information.

Checks can have the following statuses in API responses and webhooks:

Status	Description	Recommended action	Response codes
`created`	You successfully created the check.	Create an attempt.
`pending`	You successfully created an attempt and the verification/authentication URL is available.	Redirect the applicant to the flow.
`capture_in_progress`	The applicant is capturing their document and/or face.	Wait for the next status.
`checks_in_progress`	Checkout.com is processing the check.	Wait for the next status.
`screening_in_progress`	For AML Screening, Checkout.com is screening databases and generating the risk score.	Wait for the next status.
`review_required`	For AML Screening, the risk score is `LOW`, `MEDIUM`, or `HIGH`, but screening alerts were raised and a case has been created.	Investigate the case.
`approved`	The check was successful and the applicant is approved. For AML Screening, the risk score is `LOW`, `MEDIUM`, or `HIGH`, and no screening alerts were raised.	Accept the applicant's request.	`10000`
`declined`	The check was not successful and the applicant is declined. For AML Screening, the risk score is `PROHIBITED`.	Refuse the applicant's request, or create a new check.	Document issue `62101 – 62103` Copy issue `62201`, `62202` Identity fraud `62301 – 62307` Suspicious behavior `62401 – 62403`
`retry_required`	Checkout.com could not complete the check. The applicant needs to retry the flow.	Create a new attempt.	User engagement `61101`, `61111 – 61113`, `61121` Technical issue `61201 – 61205` Document capture `61301 – 61302`, `61310 – 61313`, `61315` Face capture `61401`, `61402`, `61410 – 61412`, `61414` Internal error `61901`, `61911`
`inconclusive`	Checkout.com could not complete the check and you can no longer retry.	No action is available.	`64001`
`refused`	The applicant refused to start the flow.	Suggest an alternative to the applicant.	`63001`

Each attempt can have the following statuses in API responses and webhooks:

Status	Description
`pending_redirection`	The attempt is created, but the applicant has not yet been redirected to the verification/authentication URL.
`expired`	The verification/authentication URL expired.
`capture_in_progress`	The applicant is capturing their document and/or face.
`checks_in_progress`	Checkout.com is processing the check.
`completed`	The applicant successfully completed the flow in this attempt.
`checks_inconclusive`	Checkout.com could not complete the check and you can no longer retry.
`capture_aborted`	The applicant dropped out of the flow without capturing their document and/or face.
`capture_refused`	The applicant explicitly refused to perform the capture.
`terminated`	You created a new attempt and this attempt is closed.

The following response codes provide more information about the check status:

Response code	Summary	Description	Status
`10000`	`approved`	The check was successful and the applicant is approved.	`approved`
User engagement issue
`61101`	`applicant_never_started`	The applicant was not redirected to or did not start the flow.	`retry_required`
`61111`	`applicant_not_ready`	The applicant clicked a button to state they wanted to perform the flow later.
`61112`	`applicant_no_document`	The applicant clicked a button to state they did not have their document with them.
`61113`	`camera_access_refused`	The applicant did not give access to their device camera when instructed.
`61121`	`applicant_drop`	The applicant dropped out of the flow before capturing their document and/or face and the verification/authentication URL expired.
Technical issue
`61201`	`connexion_insufficient`	The applicant's connection was too poor to capture their document and/or face.	`retry_required`
`61202`	`browser_not_supported`	The applicant's browser was not suitable for video streaming.
`61203`	`camera_not_found`	The applicant's device did not have a camera.
`61204`	`focus_lost`	The applicant switched tabs or applications during the flow.
`61205`	`sms_not_received`	The applicant did not receive the SMS.
Document capture issue
`61301`	`document_video_blurry`	The applicant's document video was too blurry. This is generally due to too much movement. If this error persists, camera quality may also be an issue.	`retry_required`
`61302`	`document_video_lighting_issue`	The applicant performed the document capture in poor light.
`61310`	`document_front_not_captured`	The applicant did not capture the front of the document.
`61311`	`document_back_not_captured`	The applicant did not capture the back of the document.
`61312`	`document_partially_hidden`	Part of the document was hidden in the capture.
`61313`	`document_not_tilted`	The applicant did not move the document dynamically.
`61315`	`document_barcode_unreadable`	The document's barcode was not readable.
Face capture issue
`61401`	`face_video_blurry`	The face video was too blurry. This is generally due to too much movement. If this error persists, camera quality may also be an issue.	`retry_required`
`61402`	`face_video_lighting_issue`	The applicant captured the face video in poor light.
`61410`	`face_not_captured`	The applicant did not present their face to the camera.
`61411`	`face_partially_hidden`	The applicant did not present a full-frontal view of their face.
`61412`	`face_not_turned`	The applicant did not move enough to prove liveness.
`61414`	`various_faces_detected`	The applicant also captured another person's face.
Internal error
`61901`	`internal_error`	Checkout.com could not complete the check due to an internal error.	`retry_required`
`61911`	`corrupted_videos`	The videos received could not be played.	`retry_required`
Document issue
`62101`	`document_expired`	The applicant presented an expired document.	`declined`
`62102`	`document_not_accepted`	The applicant presented an unsupported document.
`62103`	`document_damaged`	The applicant presented a damaged document.
Copy issue
`62201`	`document_photocopy`	The applicant presented a photocopy of the document.	`declined`
`62202`	`document_screenshot`	The applicant presented a screenshot of the document.	`declined`
Identity fraud
`62301`	`document_counterfeit`	The applicant presented a counterfeit or falsified document.	`declined`
`62302`	`document_stolen`	The applicant presented a document that has been declared lost or stolen.
`62303`	`document_swap`	The applicant presented the front and back of two different documents.
`62304`	`face_mismatch`	The applicant's face in the face video did not match the document portrait.
`62305`	`face_not_live`	The applicant presented a physical or digital photo or video of another person's face.
`62306`	`face_alteration`	The applicant altered their appearance.
`62307`	`videos_digital_alteration`	The document and/or face videos are digitally altered.
`62311`	`face_face_mismatch`	The face video does not match any previous identity verification or face authentication for this applicant.
Suspicious behavior
`62401`	`declared_identity_mismatch`	The applicant's identity did not match the details they provided.	`declined`
`62402`	`suspicious_device`	The applicant used a device that has been technically altered.
`62403`	`consent_unclear`	The applicant appears to have captured their document and/or face under coercion.
`62404`	`multiple_documents`	The applicant presented multiple documents.
User refusal
`63001`	`applicant_refusal`	The applicant clicked a button to refuse to perform the flow.	`refused`
Attempts
`64001`	`forcibly_closed`	You closed the attempt and the verification/authentication URL is no longer valid.	`inconclusive`

Identities codes
Beta

Information

Check statuses

Attempt statuses

Response codes