Selfie Validation
The Selfie Validation API, also known as the Liveness API, verifies if a user's selfie has been captured by a live individual at the time of the verification indicating no fraudulent impersonation attempt.
It also having the additional response fields to suit your business requirements.
selfie_validation
POST https://secctrl.tutelar.io/api/v1/kyc/vision/selfie_validation
Post parameters description is given below,
Post Parameter
Type
Is Mandatory
Description
selfie
String
Yes
Selfie Image Url or Base64 String
Sample Post Parameters
{
"selfie": "Image URL/Base64 String"
}{
"success": true,
"code": 200,
"message": "The request has been successfully completed.",
"reference_id": "10d7654f-b552-48b3-b75e-06cd4a967878",
"status": "completed",
"result": {
"details": {
"liveFace": {
"value": "yes",
"confidence": "high",
"score": 100
},
"qualityChecks": {
"multipleFaces": {
"value": "no",
"score": 0,
"confidence": "high"
},
"eyewear": {
"value": "no",
"score": 0,
"confidence": "high"
},
"readingGlasses": {
"value": "no",
"score": 0,
"confidence": "high"
},
"sunglasses": {
"value": "no",
"score": 0,
"confidence": "high"
},
"faceOccluded": {
"value": "no",
"score": 0,
"confidence": "high"
},
"headTurned": {
"value": "no",
"score": 0,
"confidence": "high"
},
"bright": {
"value": "no",
"score": 0,
"confidence": "high"
},
"dull": {
"value": "no",
"score": 0,
"confidence": "high"
},
"blur": {
"value": "no",
"score": 95,
"confidence": "high"
},
"eyesClosed": {
"value": "no",
"score": 0,
"confidence": "high"
},
"nonWhiteBackground": {
"value": "yes",
"score": 98,
"confidence": "high"
},
"hat": {
"value": "no",
"score": 99,
"confidence": "high"
},
"nudity": {
"value": "no",
"score": 0,
"confidence": "high"
},
"maskPresent": {
"value": "no",
"score": 0,
"confidence": "high"
}
}
},
"inputImageUrls": {
"image": ""
},
"summary": {
"action": "pass",
"details": []
}
},
"requested_at": "2024-10-01T07:01:18.335Z",
"completed_at": "2024-10-01T07:01:19.431Z"
}{
"success": false,
"code": 400,
"message": "Invalid input. Please check your request and try again.",
"error": {
"message": "Selfie image should not be empty",
"field": "selfie",
"code": "BAD_REQUEST"
}
}{
"success": true,
"code": 200,
"message": "The request could not be completed due to an error.",
"reference_id": "76d049e8-e9eb-4095-8926-74235763cf8a",
"status": "failed",
"error": {
"message": "Verification Failed.",
"code": "ERROR"
},
"requested_at": "2024-03-18T05:12:26.884Z",
"completed_at": "2024-03-18T05:12:27.305Z"
}Last updated