Identity Check
Last updated
Was this helpful?
Last updated
Was this helpful?
To run an Identity Check, you must with type
set to identity_check
.
Also, a valid clientId
, livePhotoId
, and documentId
are required.
The documentId
provided must have associated image attachments that adhere to our .
The image attachments must comply with the following:
The images must be of good quality, with a minimum of 150 DPI.
The images must be either in JPG or PNG format.
The images must be provided without blur or glare.
You must not take the image at an angle.
Each side of the document must be between 34 KB and 4 MB.
The result
object is only returned when the status of the check is complete
. It has two components - outcome
and breakdown
.
The outcome attribute represents the overall check result. Returned values include:
clear
: Indicates every analysis conducted returned a successful result, and hence the identity is authentic.
attention
: Indicates at least one of the analysis results requires attention.
The breakdown comprises the following objects:
faceAnalysis
objectThe facial analysis results. It has the following constituents:
faceDetection
: Indicates whether a face is detected and that number of faces detected on the ID and live photo are valid.
facialSimilarity
: Indicates whether the faces on the live photo and document belong to the same person.
breakdown
: Breakdown related to facial analysis.
facialSimilarityScore
: Indicates the similarity level of whether two faces belong to the same person. The score will be 1 for a perfect match.
authenticityAnalysis
objectThe facial analysis results. It has the following constituents:
spoofedImageAnalysis
: Indicates whether the images are spoofed, copied from the internet, or are known blacklisted images.
livenessCheck
: Indicates if the live photo is genuine and not a photo-of-an-image or photo-of-a-screen.
breakdown
: Breakdown related to authenticity analysis.
specimenCheckMatches
: If an image is deemed copied from the internet, this will contain an array of URLs pointing to the image.
integrityAnalysis
objectThe integrity analysis results. It has the following constituents:
faceDetection
: Indicates whether the images contained the expected number faces.