Loading...

Identity Scanner

Identity Scanner is a Zia AI-driven component that enables you to perform secure identity checks on individuals and documents by scanning and processing various ID proofs or official documents. It is a comprehensive suite that incorporates multiple functionalities divided into two major categories- E-KYC and Document Processing.

Note: 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.

Facial Comparison

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.

Note: 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.

Process Facial Comparison

Description

This API enables you to perform a face comparison between a source image and a query image. You must specify the paths to both the image files in the API request, as shown in the sample request.

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.

Request Details

Request URL

POST

{api-domain}/baas/v1/project/{project_id}/ml/facecomparison

copy

api-domain
URL
The DC-specific domain to access Catalyst API

project_id
Numerical
The unique ID of the project

Request Headers

Authorization: Zoho-oauthtoken {oauth_token}
content-type: multipart/form-data; boundary=—-WebKitFormBoundary7MA4YWxkTrZu0gW

Optional Headers

CATALYST-ORG: {org_id}

Environment: Development

Scope

ZohoCatalyst.mlkit.READ

Request JSON Properties

source_image file
mandatory

The photo ID or an individual’s photograph. You must provide the path to it in your local system.

Allowed formats: .webp, .jpeg, .png
File size limit: 10 MB

query_image file
mandatory

The photo ID or an individual’s photograph. You must provide the path to it in your local system.

Allowed formats: .webp, .jpeg, .png
File size limit: 10 MB

Response Details

The response returns the result of comparison as true if the faces match, or false if they don’t match.

The response also contains a confidence score between the range of 0 to 1. Only if the comparison yields a confidence score of above 50% i.e., 0.5, the result will be set to true.

Sample Request
copy

curl -X POST
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/facecomparison
-H “Authorization: Zoho-oauthtoken 1000.910*************************16.2f*************************57”
-H “Content-Type: multipart/form-data; boundary=—-WebKitFormBoundary7MA4YWxkTrZu0gW”
-F source_image=/Desktop/SourceImage.webp
-F query_image=/Desktop/QueryImage.webp

Sample Response
copy
{
    "status": "success",
    "data": {
        "confidence": 1.0,
        "matched": "true"
    }
}