Skip to main content

Identity 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
identity_verification_idID of the identity verification
statusstatus of the identity verification
response_codeslist of response codes

Example

{
"specversion": "2.0",
"type": "identity_verification_capture_completed",
"subject": "idv_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",
"identity_verification_id": "idv_5hxpdwegjcbujpth3wdo55d3vm",
"status": "declined",
"response_codes": [
{"code": 62301, "summary": "document_counterfeit"},
{"code": 62304, "summary": "face_mismatch"}

]
}
}

Events​

EventsDescription
identity_verification_createdYou created an identity verification
identity_verification_openedYou created a first attempt and the verification URL is available
identity_verification_startedThe applicant has been redirected to the web application
identity_verification_resetYou created a new attempt while the status was pending or capture_in_progress
identity_verification_capture_completedThe applicant completed the capture
identity_verification_checks_completedWe completed the checks
identity_verification_link_expiredThe link expired without applicant being redirected to the web application, please note the default expiration time is 15 minutes
identity_verification_capture_refusedThe applicant explicitly refused to perform the verification
identity_verification_capture_abortedThe applicant terminated the capture without completing it
identity_verification_checks_inconclusiveThe applicant did not provide the assets required to perform the checks
identity_verification_retry_requestedYou requested a retry for this identity verification
identity_verification_closedThe verification has been forcibly closed
identity_verification_anonymizedThe verification has been anonymized
identity_verification_audit_completedThe verification has been audited and the status may have been updated
identity_verification_report_createdThe pdf report is available