The API allows you to perform a 1:N query to search for a FaceHash that matches the provided face in the parameters. The maximum size of this Crop (small image) is 120x120 pixels.

Verifik has a guide on what Search services are and how to use them; we invite you to read it: Search Guide.

You can use similarity scores to determine the quality of the matches, and the information provided about the matching persons can be used for various applications such as identity verification, access control, and security systems requiring facial recognition.

This service is designed for applications that need to efficiently match smaller images with a database of known persons.

Implementation

Request

import axios from 'axios';

const options = {
  method: 'POST',
  url: '<https://api.verifik.co/v2/face-recognition/search/crops>',
  params: {
  },
  headers: {
    Accept: 'application/json',
    Authorization: 'jwt <tu_token>'
  },
  data: {
    images: ['base64_encoded_string'],
    min_score: 0.7,
    search_mode: 'FAST/ACCURATE choose one',
    collection_id: 'ID_OF_COLLECTION'
  }
};

try {
 notFou const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Response 200 - (Successful response)

{
  "id": "ABC123",
  "data": [
    {
      "id": "65807837049c624ea360c092",
      "name": "Mateo Verifik",
      "notes": "Verifik employee",
      "score": 0.9113,
      "gender": "M",
      "thumbnails": [
        {
          "id": "cfe0e19a-cb26-4e55-aa28-44769629f66b",
          "thumbnail": "Base 64 Image"
        }
      ],
      "collections": [
        {
          "id": "0dc5245b-ce51-4dce-aba8-9174c35fdfb2",
          "name": "Test25",
          "count": 1,
          "create_date": "2024-01-10T16:49:10.582314",
          "description": "Test Collection",
          "modified_date": "2024-01-10T21:55:03.400944"
        }
      ],
      "create_date": "2023-12-18T16:50:00.248794",
      "nationality": "Colombian",
      "date_of_birth": "1995-05-07",
      "modified_date": "2024-01-10T21:55:03.400944"
    }
  ],
  "signature": {
    "message": "Certified by Verifik.co",
    "dateTime": "January 16, 2024 3:41 PM"
  }
}