Facial ComparisonAdmin Scope

Notes:
  • Ensure you have installed the required package to use this SDK method.

  • Catalyst does not store any of the files you upload in its systems. The documents you upload are used for one-time processing only. They are not used for ML model training purposes either. Catalyst components are fully compliant with all applicable data protection and privacy laws.

  • While the Document Processing feature of Identity Scanner is only relevant to Indian users, the Facial Comparison API and SDK tools are available to a global audience. However, accessing and testing Facial Comparison or E-KYC from the Catalyst console is restricted to the users from IN DC alone.

Facial Comparison, also known as E-KYC, is a part of Identity Scanner that compares two faces in two different images to determine if they are the same individual. This will enable you to verify an individual’s identity from their ID proof by comparing it with an existing photo of theirs. For example, you can verify the authenticity of a photo ID, such as an individual’s Aadhaar card, by comparing it with their current photograph.

Note: You can mark either the ID proof image or the individual's photograph as the source or the query image. This will not affect the results.

You can perform a face comparison between a source image and a query image, by specifying the path to both the image files, as shown in the sample code. The compareFace() method processes both these images.

Allowed file formats: .webp, .jpeg, .png

File size limit: 10 MB

The result of the comparison is set to true if the faces match, or false if they don’t match. The result also contains a confidence score between the range of 0 to 1, that determines the accuracy of the processing. Only if the comparison yields a confidence score of above 50% i.e., 0.5, the result will be set to true.

The zia reference used in the code snippets below is the component instance created to perform these operations. The promise returned here is resolved to a JSON object.

copy
const fs = require('fs');
const sourceImage = fs.createReadStream('/Users/amelia-421/Desktop/source.webp'); // specify the file path 
const queryImage = fs.createReadStream('/Users/amelia-421/Desktop/query.webp'); // specify the file path
const res = await zia.compareFace(sourceImage, queryImage);
console.log(res);

Example of Expected Response

A sample response that you will receive is shown below.

copy
{
  "confidence": 0.9464,
  "matched": "true"
}

Last Updated 2026-07-02 14:51:41 +0530 IST