curl --location --request POST 'https://api.insights-periculum.io/verify/liveness'
--header 'Authorization: Bearer string_encrypted_access_token'
--header 'Content-Type: application/json'
--form 'statementKey=1' \
--form 'file="{image file}"'
Parameters
| Name | Description | Type | Required |
|---|---|---|---|
| statementKey | Statement Key to which KYC Integration needs to be attached | int | No |
| file | Image file to run liveness check | file | Yes |
Response
{
"success": true,
"message": "Success",
"code": "200",
"data":{
"entity":{
"liveness": {
"liveness_check": false,
"liveness_probability": 0.014614949759561568
},
"face": {
"face_detected": true,
"message": "face detected",
"multiface_detected": false,
"details": {
"age_range": {
"low": 25,
"high": 35
},
"smile": {
"value": false,
"confidence": 92.67727661132812
},
"gender": {
"value": "Female",
"confidence": 99.92608642578125
},
"eyeglasses": {
"value": false,
"confidence": 96.146484375
},
"sunglasses": {
"value": false,
"confidence": 99.99609375
},
"beard": {
"value": false,
"confidence": 85.18626403808594
},
"mustache": {
"value": false,
"confidence": 96.13561248779297
},
"eyes_open": {
"value": true,
"confidence": 88.61351776123047
},
"mouth_open": {
"value": false,
"confidence": 76.0062484741211
},
"emotions": [
{
"type": "CALM",
"confidence": 81.77631378173828
},
{
"type": "FEAR",
"confidence": 6.811796188354492
},
{
"type": "SURPRISED",
"confidence": 6.772216320037842
},
{
"type": "SAD",
"confidence": 6.691151142120361
},
{
"type": "ANGRY",
"confidence": 2.304255723953247
},
{
"type": "DISGUSTED",
"confidence": 2.147843599319458
},
{
"type": "HAPPY",
"confidence": 1.2251189947128296
},
{
"type": "CONFUSED",
"confidence": 0.9095264673233032
}
]
},
"quality": {
"brightness": 65.93645477294922,
"sharpness": 97.45164489746094
},
"confidence": 99.99896240234375,
"bounding_box": {
"width": 0.4954420328140259,
"height": 0.39241859316825867,
"left": 0.27790528535842896,
"top": 0.3333175778388977
}
}
}
}
}
NB : liveness_probability above 50 means liveness is confirmed