HumanAuthn: Biometric API Demo

Search Person

Upload face images to search enrolled persons by similarity (1:N).

menu_bookAPI reference: Face Search (1:N)expand_more

Official docs: docs.verifik.co/biometrics/search (Face Search — search by face image against enrolled persons).

Base URL https://api.verifik.co. Send one or more raw base64 images of the same subject in images (no data URL prefix). Optionally scope with collection_id. The public docs recommend 1–3 images for better recall.

POST /v2/face-recognition/search

1:N identification: returns candidate persons ranked by similarity score.

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

Param	Req	Description
images	Yes	Array of base64 face images (same person; up to ~3 suggested)
min_score	Yes	Match threshold (e.g. 0.2–1.0)
search_mode	Yes	FAST or ACCURATE
collection_id	No	Limit search to one collection
max_results	No	Cap on returned matches (API default applies if omitted)

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

This demo uses searchPersons from @humanauthn/api-client with your session token.
Responses typically include ranked matches and may include a signature block depending on environment.

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