HumanAuthn: Biometric API Demo

Search Active User

1:N face search without liveness—for active-user and session-style flows (single probe image).

menu_bookAPI reference: Face Search 1:N (Active User)expand_more

Official docs: docs.verifik.co/biometrics/search-active-user (1:N search without liveness—active-user / session flows).

Base URL https://api.verifik.co. Send one raw base64 probe in image, required os (ANDROID, IOS, or DESKTOP), plus min_score and search_mode. This demo uses DESKTOP.

POST /v2/face-recognition/search-active-user

Similar to live search, but no liveness gate—use when the user is already in an authenticated or trusted session.

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

Param	Req	Description
image	Yes	Single base64 probe image
os	Yes	ANDROID, IOS, or DESKTOP
min_score	Yes	Match threshold (0.5–1.0)
search_mode	Yes	FAST or ACCURATE
collection_id	No	Scope search to one collection

await fetch("https://api.verifik.co/v2/face-recognition/search-active-user", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    image: "<base64>",
    os: "DESKTOP",
    min_score: 0.75,
    search_mode: "FAST",
    collection_id: "<optionalCollectionMongoId>",
  }),
});

This demo uses searchActiveUser from @humanauthn/api-client with your session token.
For liveness + 1:N, use search-live-face instead (see Face Search 1:N Live in the docs).

menu_book

Official guides on docs.verifik.co

Object

The Person Object

Fields and structure of a face recognition person record.

GET

List All Persons

Persons for your client, with optional filters.

GET

Retrieve a Person

A single person by id.

PUT