Request

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

NameDescriptionTypeRequired
statementKeyStatement Key to which KYC Integration needs to be attachedintNo
fileImage file to run liveness checkfileYes

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