✅ Verify Liveness Data

Code samples

POST /webapi/kyc/user/{uuid}/liveness/verify

Body parameter

{
  "challengeToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "frames": [
    {
      "challengeIndex": 0,
      "image": "data:image/jpeg;base64,...",
      "landmarks": {},
      "blendshapes": {},
      "headPose": {},
      "timestamp": 1701424800.123
    }
  ],
  "antiSpoofing": { "score": 0.99 },
  "passport": "data:image/png;base64,...",
  "documentType": "passport",
  "country": "ru"
}

🛠️ Parameters

Name	In	Type	Required	Description
uuid	path	string(uuid)	true	Verification UUID
challengeToken	body	string	true	Token from `/liveness/start`
frames	body	object[]	true	Face video frames
frames[].challengeIndex	body	integer	true	Challenge index
frames[].image	body	string	true	Frame image in base64
frames[].landmarks	body	object	false	Face landmarks
frames[].blendshapes	body	object	false	Face blendshapes
frames[].headPose	body	object	false	Head pose data
frames[].timestamp	body	number	true	Unix timestamp of frame
antiSpoofing	body	object	true	Anti-spoofing data
passport	body	string	true	Document photo in base64
documentType	body	string	true	Document type
country	body	string	true	Country (ISO code)

Example responses

200 Response

{
  "success": true,
  "score": 0.97,
  "passed": true,
  "details": {
    "livenessScore": 0.97,
    "faceMatchScore": 0.94,
    "antiSpoofingScore": 0.99
  }
}

🔁 Responses

Status	Meaning	Description	Schema
200	OK	Verification result	Inline
404	Not Found	Verification not found	Inline
422	Unprocessable Entity	Validation error	Inline

📋 Response Schema

Name	Type	Description
success	boolean	Operation success
score	number	Combined score (0–1)
passed	boolean	Whether liveness check passed
details	object	Detailed breakdown of scores