# Face liveness

## Submit a template and photo for liveness validation

<mark style="color:green;">`POST`</mark> `https://biometrid.com/api/providers/:stepId/face-liveness-3d?processId=:processId`

This endpoint allows you to validate a liveness session.

#### Path Parameters

| Name | Type   | Description           |
| ---- | ------ | --------------------- |
| id   | string | ID of the step to get |

#### Query Parameters

| Name      | Type   | Description                             |
| --------- | ------ | --------------------------------------- |
| processId | string | ID of the process, to save the response |

#### Headers

| Name            | Type   | Description                  |
| --------------- | ------ | ---------------------------- |
| Accept-Language | string | en (default), pt             |
| Content-Type    | string | application/json             |
| Authentication  | string | Authentication account token |

#### Request Body

| Name      | Type   | Description         |
| --------- | ------ | ------------------- |
| sessionId | string | Liveness session id |
| template  | string | Liveness facemap    |
| photo     | string | Liveness photo      |

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

```javascript
{
  "data": {
    "status": true,
    "result": {
      "glasses": true,
      "sessionTokenStatus": 3,
      "faceMapType": 0,
      "livenessStatus": 0,
      "auditTrailVerificationCheck": 1,
      "isLowQuality": false,
      "auditTrailMatchCheck": 1,
      "isReplayFaceMap": true
    }
  },
  "meta": {
    "message": "Success."
  },
  "status": true
}
```

{% endtab %}

{% tab title="400 " %}

```javascript
{
  "data": {},
  "meta": {
    "message": "Invalid action type",
    "code": "BIOSSGA002"
  },
  "status": false
}

{
  "data": {},
  "meta": {
    "message": "Facemap error",
    "code": "BIOFTFL051"
  },
  "status": false
}

{
  "data": {},
  "meta": {
    "message": "Required provider field",
    "code": "BIOFTVL009"
  },
  "status": false
}
```

{% endtab %}

{% tab title="404 " %}

```javascript
{
  "data": {},
  "meta": {
    "message": "Step not found",
    "code": "BIOSSGB001"
  },
  "status": false
}
```

{% endtab %}
{% endtabs %}
