API Reference
Start typing to search…

Identity Verification (IDV)

Biometrics (IDV)

Veriff's IDV (Identity Verification) product utilizes advanced technologies to authenticate and verify user identities online. It combines AI-driven document verification, biometric facial recognition, and real-time data analysis to ensure accurate identity checks. Key technical features include automated document parsing, liveness detection to prevent spoofing, and global ID document support. The product integrates seamlessly with existing systems through APIs, offering a scalable and secure solution for verifying identities and enhancing fraud prevention.

Required Fields

  • firstName
  • lastName
  • dateOfBirth
  • phone
  • address.state (two-character state code)
  • smsText

Insights

CodeDescription
GRID-VERIFF-DECLINE-102Suspected document tampering.
GRID-VERIFF-DECLINE-103Person showing the document does not appear to match document photo.
GRID-VERIFF-DECLINE-105Suspicious behavior.
GRID-VERIFF-GRANULAR-DECLINE-106Known fraud
GRID-VERIFF-GRANULAR-DECLINE-108Velocity/abuse duplicated user
GRID-VERIFF-GRANULAR-DECLINE-109Velocity/abuse duplicated device
GRID-VERIFF-GRANULAR-DECLINE-110Velocity/abuse duplicated ID
GRID-VERIFF-GRANULAR-DECLINE-112Restricted IP location
GRID-VERIFF-GRANULAR-DECLINE-113Suspicious behaviour - Identity Farming
GRID-VERIFF-RESUBMIT-201Video and/or photos missing.
GRID-VERIFF-RESUBMIT-204Poor image quality.
GRID-VERIFF-RESUBMIT-205Document damaged.
GRID-VERIFF-RESUBMIT-206Document type not supported.
GRID-VERIFF-RESUBMIT-207Document expired.
GRID-VERIFF-RESPONSE-404Failed Response: Entry not found.
GRID-VERIFF-RESPONSE-500Failed Response: Something went wrong.
GRID-VERIFF-GRANULAR-DECLINE-502Multiple parties present in session
GRID-VERIFF-GRANULAR-DECLINE-503Attempted deceit
GRID-VERIFF-GRANULAR-DECLINE-504Attempted deceit, device screen used
GRID-VERIFF-GRANULAR-DECLINE-505Attempted deceit, printout used
GRID-VERIFF-GRANULAR-DECLINE-507Presented document tampered, data cross reference
GRID-VERIFF-GRANULAR-DECLINE-508Presented document tampered, document similarity to specimen
GRID-VERIFF-GRANULAR-DECLINE-509Person showing the document does not match document photo
GRID-VERIFF-GRANULAR-DECLINE-515Attempted deceit, device screen used for face image
GRID-VERIFF-GRANULAR-DECLINE-526Attempted deceit, photos streamed
GRID-VERIFF-GRANULAR-DECLINE-527Unable to collect proof of address data
GRID-VERIFF-GRANULAR-DECLINE-528Proof of address issue date too old
GRID-VERIFF-GRANULAR-RESUBMIT-602Presented document type not supported
GRID-VERIFF-GRANULAR-RESUBMIT-603Video missing
GRID-VERIFF-GRANULAR-RESUBMIT-605Face image missing
GRID-VERIFF-GRANULAR-RESUBMIT-606Face is not clearly visible
GRID-VERIFF-GRANULAR-RESUBMIT-608Document front missing
GRID-VERIFF-GRANULAR-RESUBMIT-609Document back missing
GRID-VERIFF-GRANULAR-RESUBMIT-614Document front not fully in frame
GRID-VERIFF-GRANULAR-RESUBMIT-615Document back not fully in frame
GRID-VERIFF-GRANULAR-RESUBMIT-619Document data not visible
GRID-VERIFF-GRANULAR-RESUBMIT-620Presented document expired
GRID-VERIFF-GRANULAR-RESUBMIT-621Document annulled or damaged
GRID-VERIFF-GRANULAR-RESUBMIT-625Unable to collect surname
GRID-VERIFF-GRANULAR-RESUBMIT-626Unable to collect first names
GRID-VERIFF-GRANULAR-RESUBMIT-627Unable to collect date of birth
GRID-VERIFF-GRANULAR-RESUBMIT-628Unable to collect issue date
GRID-VERIFF-GRANULAR-RESUBMIT-629Unable to collect expiry date
GRID-VERIFF-GRANULAR-RESUBMIT-630Unable to collect gender
GRID-VERIFF-GRANULAR-RESUBMIT-631Unable to collect document number
GRID-VERIFF-GRANULAR-RESUBMIT-632Unable to collect personal number
GRID-VERIFF-GRANULAR-RESUBMIT-633Unable to collect nationality
GRID-VERIFF-GRANULAR-RESUBMIT-634Unable to collect home address
GRID-VERIFF-GRANULAR-RESUBMIT-635Document and face image missing
GRID-VERIFF-GRANULAR-RESUBMIT-641Multiple Faces Detected
GRID-VERIFF-GRANULAR-RESUBMIT-642Multiple Documents Uploaded
GRID-VERIFF-DECISION-9001Positive: Person was verified. The verification process is complete. Accessing the sessionURL again will show the client that nothing is to be done here.
GRID-VERIFF-DECISION-9102Negative: Person has not been verified. The verification process is complete. Either it was a fraud case or some other severe reason that the person can not be verified. You should investigate the session further and read the "reason". If you decide to give the client another try you need to create a new session.
GRID-VERIFF-DECISION-9103Resubmitted: Resubmission has been requested. The verification process is not completed. Something was missing from the client and she or he needs to go through the flow once more. The same sessionURL can and should be used for this purpose.
GRID-VERIFF-DECISION-9104Negative: Verification has been expired. The verification process is complete. After 7 days the session gets expired. If the client started the verification process we reply "abandoned" here, otherwise if the client never arrived in our environment the status will be "expired"
GRID-VERIFF-DECISION-9121Review: Review status is issued whenever automation engine could not issue a conclusive decision and the verification session needs to be reviewed by a human. This status will be sent depending on service agreement.
GRID-VERIFF-SCANNED-10001Name comparison matched.
GRID-VERIFF-SCANNED-10002Negative: Name comparison mismatch.
GRID-VERIFF-SCANNED-10003State comparison matched.
GRID-VERIFF-SCANNED-10004Negative: State comparison mismatch.
GRID-VERIFF-SCANNED-10005DOB comparison matched.
GRID-VERIFF-SCANNED-10006Negative: DOB comparison mismatch.
GRID-VERIFF-OTHER-10010Verification link expired.