Introduction to Face Match API


The Face Auth. API (Face Match) compares two faces and determines if they belong to the same person.

How it works

Face Match API is an extension of the FaceVector API. When the images are sent to the Face Match API, both of the faces are converted to FaceVector templates and the Euclidian distance is calculated. Depending on the Euclidian distance, the API responds if the images are a match or not.

If the Euclidian Distance of the images is less than the threshold (Current Threshold- 0.5), that means the faces belong to the same person, the API will respond that the matches are a match. If the Euclidian distance result is more than 0.5, the faces belong to different people, the API will respond: not a match.

How to Begin

To start using the Face Match API, you need to sign up and subscribe to one of the FaceAPI plans  (View payment plans here). Learn more about signing up to the FaceAPI plans in our article “Getting Started with FaceX APIs“.


The Face Match API accepts two images as input and each Image should contain only a single face each or else bounding box parameter should be provided.

If no bounding box parameter is provided and the images contain more than one face, the Match API will auto-detect and provide the response for the first face it detects in each image.

Support articles

The following articles will talk about how to send a Face Match Request and look at the response provided by the API

Within the Face Match Category:

  1. The Post Request
  2. The Post Request with a Bounding box
  3. Bounding Box

Category: Input Feed to API
1. Image Quality for facial recognition

Related Articles
Post a Comment