Identities codes
Beta

Last updated: October 15, 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 logic 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
`approved`	The check was successful and the applicant is approved. Applies to: Identity Verification AML Screening – The risk score is `LOW`, `MEDIUM`, or `HIGH`, and no screening alerts were raised. Face Authentication ID Document Verification Response code – `10000`	Accept the applicant's request.
`capture_in_progress`	The applicant is capturing their ID document and/or face. Applies to: Identity Verification Face Authentication	Wait for the next status.
`checks_in_progress`	Checkout.com is processing the check. Applies to: Identity Verification AML Screening Face Authentication ID Document Verification	Wait for the next status.
`created`	You successfully created the check. Applies to: Identity Verification AML Screening Face Authentication ID Document Verification	Create an attempt.
`declined`	The check was not successful and the applicant is declined. Applies to: Identity Verification AML Screening – The risk score is `PROHIBITED`. Face Authentication ID Document Verification Response codes: Document issue – `62101–62104`, `62201`, `62202` Secondary document issue – `62121–62124`, `62221`, `62222` Identity fraud – `62301–62307`, `62311`, `62331–62333`, `62399` Suspicious behavior – `62401 – 62405`	Refuse the applicant's request, or create a new check.
`inconclusive`	Checkout.com could not complete the check and you can no longer retry. Applies to: Identity Verification AML Screening Face Authentication ID Document Verification Response code – `64001`	No action is available.
`pending`	You successfully created an attempt and the attempt URL is available. Applies to: Identity Verification Face Authentication Response code – `64001`	Redirect the applicant to the attempt.
`quality_checks_in_progress`	For ID Document Verification, Checkout.com is checking the document image quality.	Wait for the next status.
`refused`	The applicant refused to start the attempt. Applies to: Identity Verification Face Authentication Response code – `63001`	Suggest an alternative to the applicant.
`retry_required`	Checkout.com could not complete the check. The applicant needs to retry. Applies to: Identity Verification Face Authentication ID Document Verification Response codes: User engagement issue – `61101`, `61111–61113`, `61121` Technical issue – `61201–61205` Document capture issue – `61301–61303`, `61310–61315` Secondary document capture issue – `61321`, `61322`, `61330–61333` Face capture issue – `61401`, `61402`, `61410–61414` Internal error – `61901`, `61911`	Create a new attempt.
`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.
`screening_in_progress`	For AML Screening, Checkout.com is screening databases and generating the risk score.	Wait for the next status.

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

Status	Description
`capture_aborted`	The applicant abandoned the attempt without capturing their ID document and/or face. Applies to: Identity Verification Face Authentication
`capture_in_progress`	The applicant is capturing their ID document and/or face. Applies to: Identity Verification Face Authentication
`capture_refused`	The applicant explicitly refused to perform the capture. Applies to: Identity Verification Face Authentication
`checks_inconclusive`	Checkout.com could not complete the check and you can no longer retry. Applies to: Identity Verification Face Authentication ID Document Verification
`checks_in_progress`	Checkout.com is processing the check. Applies to: Identity Verification Face Authentication ID Document Verification
`completed`	The applicant successfully completed the attempt. Applies to: Identity Verification Face Authentication ID Document Verification
`expired`	The attempt URL expired. Applies to: Identity Verification Face Authentication
`pending_redirection`	The attempt is created, but the applicant has not yet been redirected. Applies to: Identity Verification Face Authentication
`quality_checks_in_progress`	For ID Document Verification, Checkout.com is checking for authenticity.
`quality_checks_aborted`	For ID Document Verification, the document images are insufficient quality to perform the verification, and the attempt is closed.
`terminated`	The attempt is closed because you created a new attempt. Applies to: Identity Verification Face Authentication ID Document Verification

Response codes provide more information about check statuses as follows:

Response code Summary Description

Response code	Summary	Description
`10000`	`approved`	The check was successful and the applicant is approved. Applies to: Identity Verification Face Authentication ID Document Verification

10000

approved

The check was successful and the applicant is approved.

Applies to:

Identity Verification
Face Authentication
ID Document Verification

Response code	Summary	Description
User engagement issue
`61101`	`applicant_never_started`	The applicant was not redirected to or did not start the attempt. Applies to: Identity Verification Face Authentication
`61111`	`applicant_not_ready`	The applicant clicked a button to state they wanted to perform the check later. Applies to: Identity Verification Face Authentication
`61112`	`applicant_no_document`	For Identity Verification, the applicant clicked a button to state they did not have their ID document with them.
`61113`	`camera_access_refused`	The applicant did not give access to their device camera when instructed. Applies to: Identity Verification Face Authentication
`61121`	`applicant_drop`	The applicant abandoned the attempt before capturing their ID document and/or face and the attempt URL expired. Applies to: Identity Verification Face Authentication
Technical issue
`61201`	`connection_insufficient`	The applicant's connection was too poor to capture their ID document and/or face. Applies to: Identity Verification Face Authentication
`61202`	`browser_not_supported`	The applicant's browser was not suitable for video streaming. Applies to: Identity Verification Face Authentication
`61203`	`camera_not_found`	The applicant's device did not have a camera. Applies to: Identity Verification Face Authentication
`61204`	`focus_lost`	The applicant switched tabs or applications during the attempt.
`61205`	`sms_not_received` Deprecated	The applicant did not receive the SMS.
Document capture issue
`61301`	`document_blurry`	The applicant's document video or image was too blurry. This is generally due to too much movement. If this error persists, camera quality may also be an issue. Applies to: Identity Verification ID Document Verification
`61302`	`document_lighting_issue`	The applicant performed the document capture in poor light. Applies to: Identity Verification ID Document Verification
`61303`	`document_not_in_color`	For ID Document Verification, the applicant did not capture their ID document in color.
`61310`	`document_front_not_captured`	The applicant did not capture the front of the document. Applies to: Identity Verification ID Document Verification
`61311`	`document_back_not_captured`	The applicant did not capture the back of the document. Applies to: Identity Verification ID Document Verification
`61312`	`document_partially_hidden`	Part of the document was hidden in the capture. Applies to: Identity Verification ID Document Verification
`61313`	`document_not_tilted`	For Identity Verification, the applicant did not move the document dynamically.
`61315`	`document_barcode_unreadable` Deprecated	The document's barcode was not readable.
Secondary document capture issue
`61321`	`secondary_document_blurry`	For Identity Verification, the applicant's secondary document is too blurry. This is generally due to too much movement. If this error persists, camera quality may also be an issue.
`61322`	`secondary_document_lighting_issue`	For Identity Verification, the applicant performed the secondary document capture under poor lighting conditions.
`61330`	`secondary_document_front_not_captured`	For Identity Verification, the applicant did not capture the front of the secondary document.
`61331`	`secondary_document_back_not_captured`	For Identity Verification, the applicant did not capture the back of the secondary document.
`61332`	`secondary_document_partially_hidden`	For Identity Verification, the applicant hid part of the secondary document.
`61333`	`secondary_document_not_tilted`	For Identity Verification, the applicant did not move the secondary document sufficiently.
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. Applies to: Identity Verification Face Authentication
`61402`	`face_video_lighting_issue`	The applicant captured the face video in poor light. Applies to: Identity Verification Face Authentication
`61410`	`face_not_captured`	The applicant did not present their face to the camera. Applies to: Identity Verification Face Authentication
`61411`	`face_partially_hidden`	The applicant did not present a full-frontal view of their face. Applies to: Identity Verification Face Authentication
`61412`	`face_not_turned`	The applicant did not move enough to prove liveness. Applies to: Identity Verification Face Authentication
`61414`	`various_faces_detected` Deprecated	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. Applies to: Identity Verification Face Authentication ID Document Verification
`61911`	`corrupted_videos`	The videos received could not be played.

Response code	Summary	Description
Document issue
`62101`	`document_expired`	The applicant presented an expired document. Applies to: Identity Verification ID Document Verification
`62102`	`document_not_accepted`	The applicant presented an unsupported document. Applies to: Identity Verification ID Document Verification
`62103`	`document_damaged`	The applicant presented a damaged document. Applies to: Identity Verification ID Document Verification
`62104`	`unsupported_alphabet`	The applicant's document contains an unsupported alphabet. Only the Latin alphabet is supported. Applies to: Identity Verification ID Document Verification
`62201`	`document_photocopy`	The applicant presented a photocopy of the document. Applies to: Identity Verification ID Document Verification
`62202`	`document_screenshot`	The applicant presented a screenshot of the document. Applies to: Identity Verification ID Document Verification
Secondary document issue
`62121`	`secondary_document_expired`	For Identity Verification, the applicant presented an expired secondary document.
`62122`	`secondary_document_not_accepted`	For Identity Verification, the applicant presented an unsupported secondary document.
`62123`	`secondary_document_damaged`	For Identity Verification, the applicant presented a damaged secondary document.
`62124`	`secondary_document_unsupported_alphabet`	For Identity Verification, the applicant's secondary document contains an unsupported alphabet. Only the Latin alphabet is supported.
`62221`	`secondary_document_photocopy`	For Identity Verification, the applicant presented a photocopy of the secondary document.
`62222`	`secondary_document_screenshot`	For Identity Verification, the applicant presented a screenshot of the secondary document.
Identity fraud
`62301`	`document_counterfeit`	The applicant presented a counterfeit or falsified document. Applies to: Identity Verification ID Document Verification
`62302`	`document_stolen`	The applicant presented a document that has been declared lost or stolen. Applies to: Identity Verification ID Document Verification
`62303`	`document_swap`	The applicant presented the front and back of two different documents. Applies to: Identity Verification ID Document Verification
`62304`	`face_mismatch`	For Identity Verification, 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. Applies to: Identity Verification Face Authentication
`62306`	`face_alteration`	The applicant altered their appearance. Applies to: Identity Verification Face Authentication
`62307`	`asset_digital_alteration`	The document and/or face videos are digitally altered. Applies to: Identity Verification Face Authentication ID Document Verification
`62311`	`face_face_mismatch`	For Face Authentication, the face video does not match any previous face authentication for this applicant.
`62331`	`secondary_document_counterfeit`	For Identity Verification, the applicant presented a counterfeit or falsified secondary document.
`62332`	`secondary_document_stolen`	For Identity Verification, the applicant presented a secondary document that has been declared lost or stolen.
`62333`	`secondary_document_swap`	The applicant presented the front and back of two different secondary documents. Applies to: Identity Verification ID Document Verification
`62334`	`secondary_document_mismatch`	For Identity Verification, the applicant is not the holder of the secondary document.
`62399`	`generic_fraud`	For certified Identity Verification, the verification is fraudulent.
Suspicious behavior
`62401`	`declared_identity_mismatch`	The applicant's identity did not match the details they provided. Applies to: Identity Verification ID Document Verification
`62402`	`suspicious_device`	The applicant used a device that has been technically altered. Applies to: Identity Verification Face Authentication
`62403`	`consent_unclear`	The applicant appears to have captured their document and/or face under coercion. Applies to: Identity Verification Face Authentication
`62404`	`multiple_documents`	The applicant presented multiple documents. Applies to: Identity Verification ID Document Verification
`62405`	`known_fraudulent_face`	The applicant is known to have previously attempted fraud. Applies to: Identity Verification Face Authentication

Response code	Summary	Description
`63001`	`applicant_refusal`	The applicant clicked a button to refuse to perform the check.

Response code	Summary	Description
`64001`	`forcibly_closed`	You closed the attempt and the attempt URL is no longer valid.

Identities codes
Beta

Information

Check statuses

Attempt statuses

Response codes

approved status

retry_required status

declined status

refused status

inconclusive / pending status