HumanAuthn: Biometric API Demo

Verify Face

1:1 verification against an enrolled person by ID.

menu_bookAPI reference: Verify Face (1:1)expand_more

Official docs (EN): docs.verifik.co/biometrics/verify-face. Spanish: docs.verifik.co/verifik-es/verificar-cara.

Base URL https://api.verifik.co. Send the enrolled person's MongoDB id in id and one or more raw base64 face images in images (no data URL prefix). Optional collection_id scopes the check.

POST /v2/face-recognition/verify

1:1 against a known enrolled person: returns a data.match with score when the threshold is met.

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

Param	Req	Description
id	Yes	Enrolled person MongoDB id
images	Yes	Array of base64 face images (same subject)
min_score	Yes	Match threshold (0.5–1)
search_mode	Yes	FAST or ACCURATE
collection_id	No	Optional collection scope

await verifyFace(
  {
    id: "<personMongoId>",
    images: ["<base64>", "<base64>"],
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  },
  accessToken,
);

This demo uses verifyFace from @humanauthn/api-client with your session token.
Responses include data.match and a signature block when enabled.

menu_book

Official guides on docs.verifik.co

POST

Face Comparison

1:1 face comparison between two image sets without an enrolled person id.

POST

Face Comparison (Live)

1:1 comparison with liveness on the probe image.

POST

Compare with Liveness

1:1 comparison plus configurable liveness thresholds.

POST