VKYC liveness check

POST

https://api-dev.myemipay.com/application/vkyc/liveness

Last modified:2026-09-28 06:34:55

VKYC liveness check

Description: checks that the selfie is a real face, not a blank frame.

Usage: VKYC screen, after the customer has an open application. Call this before face-match. It does not move the journey step.

Details: body { image } — JPEG or PNG as base64. A data:image/...;base64, prefix is fine. { live: true } means a face was found. { live: false } means retake the selfie (face not in the frame). Empty or non-image text is 422.

Next: POST /application/vkyc/face-match with the same selfie plus the ID portrait.

Auth: Authorization: Bearer {{accessToken}}

Errors: 401 unauthorized | session_expired · 404 not_found · 422 validation_failed | provider_failed

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢200Live face

application/json

Bodyapplication/json

🟠401Unauthorized

🟠422Selfie required

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api-dev.myemipay.com/application/vkyc/liveness' \
--header 'Authorization: Bearer ' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

200 - Live face

{
  "live": true
}

Modified at 2026-09-28 06:34:55

Loan eligibility

VKYC face match