Face Passive Liveness V1

The Face Passive Liveness V1 API uses computer vision to verify the presence of a real, live person in an image — without requiring any action or movement from the user. It distinguishes genuine faces from spoofing attempts such as printed photos, digital screens, or masks.

How It Works

Submit a single Base64-encoded face image. The API analyzes it and returns a liveness score and percentage, indicating the likelihood that the image represents a real, live person. A score above the threshold confirms 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 and not heavily occluded (no sunglasses, masks, etc.).
• Only camera-captured images are accepted — screenshots will be rejected.
• The image should be taken in portrait mode as a selfie.

Response

On success, the API returns:

• liveness — liveness percentage score (e.g., "99.68").
• matchscore — raw liveness confidence score.
• threshhold — the threshold value used to determine liveness (default: 50).
• quality — image quality score.
• fileid — internal file reference (nullable).

curl -X POST "https://api.syntizen.com/CheckLiveness" \  -H "apikey: 0" \  -H "authkey: string" \  -H "Content-Type: application/json" \  -d '{    "rrn": "1",    "liveimage": "/9j/4f//SQAcqBk9s9aevJMisuwA7h0zUeQwyR8oHapByrDgfhxQDiPAwwfaOOfr6VMCW+UbQfyqI5GZGzv4zx0FS4JJV9uOg+tBVj//Z"  }'

{
  "respcode": "200",
  "respdesc": "face liveness check completed",
  "rrn": "1",
  "matchscore": "0.9968439638614655",
  "quality": "0",
  "liveness": "99.68",
  "fileid": null,
  "threshhold": "50"
}

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

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