> For the complete documentation index, see [llms.txt](https://developer.myidentitypass.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.myidentitypass.com/products/biometric/face-1/face-liveliness-check.md).

# Face Liveliness Check

## Face liveliness Check

<mark style="color:green;">`POST`</mark> `https://api.myidentitypay.com/api/v2/biometrics/merchant/face/liveliness_check`

This endpoint allows you to authenticate user with liveliness check on face

#### Query Parameters

| Name                                    | Type   | Description                     |
| --------------------------------------- | ------ | ------------------------------- |
| image<mark style="color:red;">\*</mark> | string | user image url(png,jpg,base64)) |

#### Headers

| Name                                        | Type   | Description                 |
| ------------------------------------------- | ------ | --------------------------- |
| x-api-key<mark style="color:red;">\*</mark> | string | \<your merchant secret key> |
| app-id<mark style="color:red;">\*</mark>    | String | \<your app id>              |

{% tabs %}
{% tab title="200 " %}

```
{
    "status": true,
    "detail": "Liveliness Detected",
    "confidence": 0.99,
    "confidence_in_percentage":99.9
    "verification": {
        "status": "",
        "reference": ""
    }
}
```

{% endtab %}
{% endtabs %}