Face Passive Liveness V2

A face comparison system examines an image of a face and predicts whether the face matches other faces in a database. Face comparison systems compare and predict potential matches of faces based on expression, facial hair, and age.

The Face Passive Liveness V2 API uses computer vision biometrics to detect the presence of a real, live user — rather than a representation such as a printed photo, a digital screen replay, or a mask. It returns a liveness score indicating the confidence that the submitted image is of a live person.

How It Works

Submit a single Base64-encoded face image. The API analyzes it and returns a liveness_score (percentage) and liveness_status indicating whether the face is live. A higher score means greater confidence in liveness.

Request Parameters

Image Guidelines

• Supported formats: JPG, PNG.
• The image must contain exactly one clearly visible, forward-facing human face.
• The face should be well-lit with no heavy occlusions (sunglasses, masks, hats).
• Only live camera-captured images are accepted — screenshots will be rejected.
• Take the image in portrait mode as a selfie for best results.

Response

On success, the API returns a data object containing:

• liveness_status — result of the check (e.g., "Success").
• liveness_score — confidence percentage that the image is live (e.g., "98.94").

curl -X POST "https://api.syntizen.com/FaceLivenessV2" \  -H "apikey: 0" \  -H "authkey: string" \  -H "Content-Type: application/json" \  -d '{    "liveimage": "/9j/4AAQSkZJRgABAgAAAQABAAD/2wBDAAgGBgcGBQgHBwc",    "rrn": "1"  }'

{
  "respcode": "200",
  "respdesc": "success",
  "rrn": "1",
  "data": {
    "liveness_status": "Success",
    "liveness_score": "98.939384"
  }
}

{
  "respcode": "400",
  "respdesc": "Bad Request - Missing or invalid request parameters"
}

{
  "respcode": "401",
  "respdesc": "Unauthorized - Invalid or expired auth key"
}