Handle address verification results

Analyze Non-Doc Verification data to clarify rejection and approval reasons.

Once the check is performed, you will receive a webhook with the verification status:

  • The reviewResult object contains extra information about verification.
  • The reviewAnswer field contains the final verification result, displaying the GREEN or RED status:
    • GREEN — the applicant has passed Non-Doc Verification and their data has been successfully obtained from the government database.
    • RED — the applicant has not passed verification; the reviewRejectType is set to RETRY or FINAL.

Get verification check details

To get a structured view of the applicant data, use this API method with the type parameter set to RESIDENCY_CHECK.

curl --request GET \
     --url 'https://api.sumsub.com/resources/checks/latest?type=RESIDENCY_CHECK&applicantId=65c607aa36997b590dcdf127' \

Clarify rejection reason

For every rejection reason, we have a particular buttonId attached to the applicant or photo. To get a list of rejection reasons based on the applicant ID, use this API method.

Rejection typeValueRejection reason
FINALdbNetReject_dataMismatchThe provided data does not match the data from the sources.
FINALdbNetReject_nameMismatchThe provided name does not match the data from the sources.
FINALdbNetReject_addressMismatchThe provided address does not match the data from the sources.
FINALdbNetReject_dobMismatchThe provided date of birth does not match the data from the sources.

😀

Did you know?

When applicants skip or fail Non-Doc Verification, they can be moved to another flow for passing verification using documents.