Search Crops
1:N search using face crops (small regions). min_score must be between 0.5 and 1.
menu_bookAPI reference: Face Search 1:N (Crops)expand_more
Official docs: docs.verifik.co/biometrics/search-crops (1:N search for face crops; min_score is 0.5–1, unlike standard Face Search).
Base URL https://api.verifik.co. Send one or more entries in images as raw base64 or HTTPS URLs to images (the API may fetch URLs server-side). Optionally set collection_id and max_results.
POST /v2/face-recognition/search/crops
Returns ranked candidate persons in data, same general shape as /face-recognition/search.
| Header | Value |
|---|---|
| Content-Type | application/json |
| Authorization | Bearer <token> |
| Param | Req | Description |
|---|---|---|
| images | Yes | Face crops (base64 and/or HTTPS URLs), same subject |
| min_score | Yes | 0.5–1 |
| search_mode | Yes | FAST or ACCURATE |
| collection_id | No | Limit search to one collection |
| max_results | No | Cap on returned matches |
await searchCrops(
{
images: ["<base64>", "<base64>"],
min_score: 0.75,
search_mode: "FAST",
collection_id: "<optionalCollectionMongoId>",
max_results: 10,
},
accessToken,
);- This demo uses
searchCropsfrom@humanauthn/api-clientwith your session token. - Responses typically include ranked matches and may include a
signatureblock depending on environment.
Related documentation
Official guides on docs.verifik.co
Face Search (1:N)
Standard gallery search with full face images; lower min_score floor (0.2–1).
Face Search 1:N (Live)
Liveness on the probe image, then 1:N search.
Face Search 1:N (Active User)
1:N search for active-session flows without liveness on the probe.
Verify Face (1:1)
Match probe images against a known enrolled person id.
Face Detection
Detect faces in an image to obtain crops before searching.
List All Persons
Inspect enrolled persons for your client.