HumanAuthn: Biometric API Demo

Create Person with Liveness

Enroll + liveness check + deduplication search in one call.

menu_bookAPI reference: Create Person with Livenessexpand_more

Official docs (English): docs.verifik.co/resources/create-a-person-with-liveness

Documentación (Español): docs.verifik.co/verifik-es/resources/personas/crear-una-persona-con-deteccion-de-vida

Base URL https://api.verifik.co. Send JSON with profile fields, a single collection_id (collection _id), liveness and search thresholds, and at least one base64 face image per entry in images (no data URL prefix).

POST /v2/face-recognition/persons/search-live-face

Runs liveness on the submitted face(s), searches for similar enrollments, then creates or updates a person in the target collection.

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

Param	Req	Description
name	Yes	Display name
images	Yes	Array of base64 face images (raw base64, not data URLs)
gender	Yes	M or F
date_of_birth	Yes	YYYY-MM-DD
collection_id	Yes	Single collection unique id
liveness_min_score	Yes	0.5–1
min_score	Yes	Internal search threshold, 0.5–1
search_mode	Yes	FAST or ACCURATE
nationality	No	Optional

await fetch("https://api.verifik.co/v2/face-recognition/persons/search-live-face", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${accessToken}`,
  },
  body: JSON.stringify({
    name: "Jane Doe",
    gender: "F",
    date_of_birth: "1990-01-15",
    collection_id: "<collectionMongoId>",
    liveness_min_score: 0.65,
    min_score: 0.8,
    search_mode: "FAST",
    nationality: "CO",
    images: ["<base64>", "<base64>"],
  }),
});

This demo uses createPersonWithLiveness from @humanauthn/api-client with your session token.
Responses may include a signature block alongside data 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