HumanAuthn: Biometric API Demo

Capture

Result

menu_bookAPI reference: Livenessexpand_more

Official docs: docs.verifik.co/biometrics/liveness

This demo calls POST /v2/face-recognition/liveness with os and image (base64). Pass/fail uses liveness_score against min_score (default 0.6 when liveness_min_score is omitted).

POST /v2/face-recognition/liveness

Returns a liveness score and passed when the score exceeds the minimum threshold.

Header	Value
Content-Type	application/json
Authorization	Bearer <token>

Param	Type	Req	Description
os	string	Yes	`DESKTOP`, `IOS`, or `ANDROID`
image	string	Yes	Base64 image (or https URL; server may fetch)
collection_id	string	No	Optional collection for the attempt
liveness_min_score	number	No	Threshold for pass/fail (default 0.6)

await fetch("https://api.verifik.co/v2/face-recognition/liveness", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    os: "DESKTOP",
    image: "<base64>",
    liveness_min_score: 0.6,
  }),
});

// 200 OK, example shape
{
  "id": "…",
  "data": {
    "passed": true,
    "min_score": 0.6,
    "liveness_score": 0.98
  },
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "…"
  }
}

Responses include id and a signature block alongside data.
Omitting os returns 409 with MissingParameter.

Liveness Detection

Select a source to verify human presence.

Test Samples

Tap a portrait to run liveness on a stock photo (same as uploading).