---
title: "Liveness (selfie) verification"
method: POST
path: "/verify/liveness"
tags: ["Liveness"]
---

# Liveness (selfie) verification

`POST /verify/liveness`

Performs liveness verification using a selfie image. Delegates to the configured verification provider with verification_type="liveness".

Supported media types: jpeg/jpg, png, BMP.

Guidelines:
- Higher image size increases upload and processing time; reduce image size while preserving required quality.
- Minimum recommended image size: 300x300 pixels with the face covering ~75% of the frame (≈220x220).
- Capture only live photographs — do not use printed photos or video-graphed frames.
- Background should be plain white and no other person should appear in the frame.
- Capture vertically (portrait), avoid skew/tilt; watermark (if any) must be readable.
- Ensure good lighting so the user is clearly visible and recognizable.

## Request body

- LivenessRequest
  - `person` string, required — Base64-encoded image data or URL of the selfie image (when sending JSON)

## Response `200`

Liveness verification result

- LivenessResponse
  - `status` string, required
  - `message` string, nullable
  - `error_code` string, nullable
  - `data` LivenessData
    - `is_live` boolean, nullable
    - `liveness_score` unknown
    - `extras` object, nullable
  - `tranx_id` string, nullable
  - `timestamp` string, nullable

## Other responses

- `400` — Invalid request or missing/unsupported media
- `401` — Unauthorized - Invalid or missing API key / client id
- `422` — Unprocessable - image quality or face not detected
- `500` — Internal Server Error - provider or server error

---

[API](https://skmtc.dev/idto/apis/verification-api.md) · [All operations](https://skmtc.dev/idto/apis/verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idto/verification-api/revisions/e3d57dab8db4/schema)