Using Artificial Intelligence to validate Liveliness check. With this endpoint, users can provide their facial features as input to the system, which will then perform a liveliness check to ensure that the user is present and not just a still image or pre-recorded video. This ensures the security and reliability of the authentication process, as it reduces the risk of unauthorized access by fraudulent means.

📘

POST

{{URL}}/dikript/api/v1/biometrics/livelinesscheck



Request Body

📘

NOTE

At least one of these parameter type is required

Content-Type: multipart/form-data

KeyValueDescriptionRequired
ImageDocfileThe actual image document could be (jpg, png etc)
ImageBase64StringtextBase64 encoded string of the image
ImageUrltextimage url (must be https)

SDKs

AngularJs SDK

https://www.npmjs.com/package/dikript-angular-live-face-sdk

ReactJs SDK

https://www.npmjs.com/package/dikript-react-live-face-sdk

VueJs SDK

https://www.npmjs.com/package/dikript-vue-live-face-sdk


Response Body

{
    "status": true,
    "message": "Successful",
    "code": "200",
    "apiVersion": "v1",
    "transactionRef": "N202411020543011852",
    "data": {
        "isLively": false,
        "detail": {
            "liveness": {
                "livenessCheck": false,
                "livenessProbability": 100.0
            },
            "faceRectangle": {
                "top": 216,
                "left": 288,
                "width": 193,
                "height": 193
            },
            "attributes": {
                "gender": {
                    "value": "Male"
                },
                "age": {
                    "value": 37
                },
                "headpose": {
                    "pitchAngle": 10.63662,
                    "rollAngle": -1.7373753,
                    "yawAngle": 5.4974313
                },
                "blur": {
                    "blurness": {
                        "value": 0.328,
                        "threshold": 50.0
                    },
                    "motionblur": {
                        "value": 0.328,
                        "threshold": 50.0
                    },
                    "gaussianblur": {
                        "value": 0.328,
                        "threshold": 50.0
                    }
                },
                "eyestatus": {
                    "leftEyeStatus": {
                        "noGlassEyeOpen": 99.991,
                        "noGlassEyeClose": 0.0,
                        "normalGlassEyeOpen": 0.002,
                        "normalGlassEyeClose": 0.0,
                        "darkGlasses": 0.0,
                        "occlusion": 0.007
                    },
                    "rightEyeStatus": {
                        "noGlassEyeOpen": 99.957,
                        "noGlassEyeClose": 0.0,
                        "normalGlassEyeOpen": 0.042,
                        "normalGlassEyeClose": 0.0,
                        "darkGlasses": 0.0,
                        "occlusion": 0.001
                    }
                },
                "emotion": {
                    "anger": 0.0,
                    "disgust": 0.0,
                    "fear": 0.0,
                    "happiness": 100.0,
                    "neutral": 0.0,
                    "sadness": 0.0,
                    "surprise": 0.0
                },
                "facequality": {
                    "value": 85.982,
                    "threshold": 70.1
                },
                "beauty": {
                    "maleScore": 66.168,
                    "femaleScore": 70.392
                },
                "glass": {
                    "value": "None"
                }
            }
        },
        "confidence": 100.0
    },
    "error": null
}
{
  	"status":false,
    "message": "Unsuccessful",
    "code": "400",
    "apiVersion": "v1",
    "transactionRef": "N202401101345487388",
    "data": "",
    "error": {
        "code": 400,
        "message": null
    }
}