Additional Checks for Liveness
The following table lists the additional checks that can be executed on a selfie. These are also called the liveness checks.
Caution
We highly recommend contacting the HyperVerge team before attempting to implement any of these checks to avoid any unexplainable scenario.
note
All of the checks listed on this page are enabled by setting the parameter values to "yes".
Quality Checks
| Type of Check | Description | Parameter | Accepted Values | Key in Response |
|---|---|---|---|---|
| Eyes Closed | Checks if the eyes of the individual are closed in the selfie. | qualityChecks.eyesClosed | "yes" or "no" | eyesClosed |
| Multiple Faces | Checks if the selfie has multiple faces. | qualityChecks.multipleFaces | "yes" or "no" | multipleFaces |
| Blur | Checks if the selfie is blurred. | qualityChecks.blur | "yes" or "no" | blur |
| Return Score | Returns a score in the range of 0 to 100 for applicable fields. | preferences.returnScore | "yes" or "no" | returnScore |
| Hat | Checks if the individual is wearing a hat in the selfie. | qualityChecks.hat | "yes" or "no" | hat |
| Sunglasses | Checks if the individual is wearing sunglasses in the selfie. | qualityChecks.sunglasses | "yes" or "no" | sunglasses |
| Reading Glasses | Checks if the individual is wearing reading glasses in the selfie. | qualityChecks.readingGlasses | "yes" or "no" | readingGlasses |
| Dull | Checks if the selfie is under exposed. | qualityChecks.dull | "yes" or "no" | dull |
| Bright | Checks if the selfie is over exposed. | qualityChecks.bright | "yes" or "no" | bright |
| Head Turned | Checks if the head of the individual not aligned properly in the selfie. | qualityChecks.headTurned | "yes" or "no" | headTurned |
| Eyewear | Checks if the individual is wearing any eye wear in the selfie. | qualityChecks.eyewear | "yes" or "no" | eyewear |
| Occlusion | Checks if the individual's face is hidden or obscured from view in the selfie. | qualityChecks.occlusion | "yes" or "no" | occlusion |
| Nudity | Checks the selfie for any explicit content. | qualityChecks.nudity | "yes" or "no" | nudity |
| Non White Background | Checks if the background is not white. | qualityChecks.nonWhiteBackground | "yes" or "no" | nonWhiteBackground |
Fraud Checks
note
We support fraud checks for detecting injection attacks, anomalies, and deepfake attacks in selfie images. To enable these checks for your implementation, please get in touch with our Support team.
Other Checks
| Type of Check | Description | Parameter | Accepted Values | Key in Response |
|---|---|---|---|---|
| Retrieve Input Image URLs | Provides the links to access each of the input images in the response. | returnInputImageUrls | "yes" or "no" | returnInputImageUrls |
| Enable Retakes on Success | Enables a customer to retake the identification journey. | qualityChecks.allowSuccessRetakes | "yes" or "no" | allowSuccessRetakes |
| Age Range | Provides the age range of the person in the selfie. | qualityChecks.ageRange | "yes" or "no" | ageRange |
Sample Response
The following is a sample response when the non-white background check in enabled.
{
"status": "success",
"statusCode": 200,
"metadata": {
"requestId": "1710874594970-280e864e-2b88-4559-a385-3553f553301d",
"transactionId": "12345"
},
"result": {
"details": {
"liveFace": {
"value": "yes",
"confidence": "high"
},
"qualityChecks": {
"nonWhiteBackground": {
"value": "yes",
"confidence": "high"
}
}
},
"summary": {
"action": "pass",
"details": []
}
}
}