HumanAuthn: Biometric API Demo

Create Person

Enroll a new person with face images and metadata.

menu_bookAPI reference: Create Personexpand_more

Official docs: docs.verifik.co/resources/create-a-person

Base URL https://api.verifik.co. Send JSON with profile fields and at least one base64 face image per entry in images (no data URL prefix). The public docs also list optional fields such as notes, email, and phone.

POST /v2/face-recognition/persons

Enrolls a new person into the given collection ids (collection _id values) with face biometrics for OpenCV-backed recognition.

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 (required in this demo)
date_of_birth	Yes	YYYY-MM-DD (required in this demo)
collections	Yes	Array of collection `_id` strings; this demo loads them from `GET /v2/face-recognition/collections` and lets you pick one or more.
nationality	No	Optional country / nationality code or label

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

// 200 OK — example shape
{
  "data": {
    "id": "…",
    "name": "Jane Doe",
    "gender": "F",
    "date_of_birth": "1990-01-15",
    "collections": ["…"],
    "…": "…"
  }
}

This demo uses createPerson from @humanauthn/api-client with your session token.
Responses may include id and 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