Skip to main content

ID Document Verification

Body​

The webhook body contains the following information:

AttributeDescription
applicant_idID of the applicant, useful to recognize them
external_applicant_idYour applicant ID, only if you updated it in the applicant object
user_journey_idID of the user journey
id_document_verification_idID of the identity verification
statusstatus of the identity verification
response_codeslist of response codes

Example

{
"specversion": "2.0",
"type": "id_document_verification_checks_completed",
"subject": "iddv_5hxpdwegjcbujpth3wdo55d3vm",
"id": "evnt_5hxpdwegjcbujpth3wdo55d3vm",
"time": "2023-03-22T17:31:00Z",
"datacontenttype": "application/json",
"data": {
"external_applicant_id": "9fj3lz918bujpth3wdolmc74s"
"applicant_id": "aplt_5hxpdwegjcbujpth3wdo55d3vm",
"user_journey_id": "usj_5hxpdwegjcbujpth3wdo55d3vm",
"id_document_verification_id": "idv_5hxpdwegjcbujpth3wdo55d3vm",
"status": "declined",
"response_codes": [
{"code": 62301, "summary": "document_counterfeit"},

]
}
}

Events​

EventsDescription
id_document_verification_createdYou created a document verification
id_document_verification_quality_checks_in_progressYou created a first attempt and we assess the quality of the images
id_document_verification_checks_in_progressWe completed the quality assessment and perform the safety checks
id_document_verification_checks_completedWe completed the safety checks
id_document_verification_quality_checks_abortedThe applicant did not provide assets of good enough quality to perform the verification
id_document_verification_checks_inconclusiveThe applicant did not provide the assets required to perform the checks
id_document_verification_retry_requestedYou requested a retry for this document verification
id_document_verification_closedThe verification has been forcibly closed
id_document_verification_anonymizedThe document verification has been anonymized
id_document_verification_audit_completedThe verification has been audited and the status may have been updated
id_document_verification_report_createdThe pdf report is available