---
title: "livenessCheck"
method: POST
path: "/liveness"
tags: ["liveness"]
---

# livenessCheck

`POST /liveness`

This method submits a biometric sample for liveness check.

## Request body

- LivenessCheckRequest
  - `data` LivenessCheckBiometric
    - `source` 'ORIGINAL' — How the biometric data was obtained. The value must be `ORIGINAL`.
    - `type` 'FACE' — Type of the biometric data. The value must be `FACE`.
    - `format` 'JPEG' | 'JPEG2000' | 'PNG' | 'TIFF' | 'GIF' | 'BMP' — Format of the biometric data. `REQUIRED`.
    - `content` string — Base64 encoded biometric data. `REQUIRED`.

## Response `200`

OK

- LivenessCheckResponse
  - `tguid` string — Global unique ID of the transaction.
  - `bonafideScore` integer — Bonafide score of the liveness verification. Ranges from 0 to 100 (0=attack, 100=genuine).

---

[API](https://skmtc.net/griaule/apis/gbds-api.md) · [All operations](https://skmtc.net/griaule/apis/gbds-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/griaule/gbds-api/revisions/fa80f482ec5e/schema)