---
title: "Liveness Check"
method: POST
path: "/v1/liveness-check"
tags: ["Face Forensics"]
---

# Liveness Check

`POST /v1/liveness-check`

Liveness Check is a process of verifying that a real person is present and not a photo or video. It is a critical step in the KYC process.
This API is used to perform a liveness check on a user through passive liveness check. It takes an image/selfie of the user and checks if the user is real or not.

## Request body

- LivenessCheckPayload
  - `image` string, required

## Response `200`

Successful Response

- union
  - RESPONSELIVENESSCHECKSUCCESSFUL
    - `code` integer
    - `timestamp` integer, required
    - `transaction_id` string, required
    - `sub_code` string
    - `message` string
    - `data` LivenessCheckData, required
      - `is_live` boolean, required
      - `score` integer, required
  - RESPONSELIVENESSFACENOTDETECTED
    - `code` integer
    - `timestamp` integer, required
    - `transaction_id` string, required
    - `sub_code` string
    - `message` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide.md) · [All operations](https://skmtc.dev/deepvue/apis/deepvue-tech-developers-guide/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/deepvue/deepvue-tech-developers-guide/revisions/c1b0558e7d77/schema)