Skip to content

Published services, current details, and clear categories.

Explore APIs
KYC12 APIsPopular

Face Match Verification API

Compare a captured face image with a reference photo from an identity document or an existing customer record. Use the result in your own onboarding, re-verification or fraud review.

selfie · live capturedocument photomatch_score97.4%MATCHthreshold 0.85 · five landmark pairs0.85
Request and response

You confirm the required fields and consent steps with us during onboarding.

You send

A captured face image and a reference face image

You receive

Structured similarity and image-quality information, where available

Coverage
India-wide onboarding and re-verification journeys. Supported image sources depend on your service contract.
Typical users
Lending, insurance, fintech, marketplaces, logistics, staffing and telecom teams
Coverage note
Fields available vary by data source and record, and by your service contract
Overview

What you can do with the Face Match Verification API

Face match compares two face images and returns a structured similarity result your application can act on. One image is captured during the check. The other is one the business already trusts, such as the photograph on a submitted identity document or a photo held in an existing customer record. Read the result as a signal, not a verdict. Teams usually read it alongside document verification and the other checks in the same journey. Strong comparisons move forward, borderline ones go to a reviewer, and an unusable image is captured again. Face match confirms that two images show the same person. It does not confirm that the capture came from a live person at the camera, which is what the separate Face Liveness service checks. Most identity journeys run the two together, with consent recorded for both. The fields available in a response can vary by data source and record.

  • A comparison result you can route on

    Send a captured image and a reference image and receive a structured similarity result, together with the image-quality signals the service returns. The fields available vary by data source and record, and by your service contract.

  • Runs alongside a liveness check

    Face match can confirm that two images show the same person. It cannot confirm that the capture was a live person. Running it after the separate Face Liveness service narrows the gap that a printed photo or a screen replay would otherwise leave open.

  • The same comparison on every file

    Manual photo comparison depends on who is reviewing and how long the queue is. An API applies one comparison to every case. Onboarding at volume does not drift with the reviewer or the hour.

  • Built for a consented journey

    A face image is personal data. The check is designed for journeys where the person has been told what the image will be compared against and has agreed to it. Use of the result stays inside the purpose you declared.

How it works

The five-step Face Match Verification API workflow

Our team walks you through the exact request and response for this service during onboarding.

Step 1

Capture the face image with consent

Take the capture inside a guided step in your app or web journey. Run it after the person has been told what the image will be compared against, and has agreed to it.

Step 2

Pick the reference photo

Supply the photo you already trust: the image read from a submitted identity document, an enrollment photo, or one held in the customer record.

Step 3

Send both images for comparison

Your application submits the pair through the API as part of the onboarding, re-verification or review step it already runs.

Step 4

Read the similarity and quality signals

The response returns the available similarity and image-quality information as structured fields. Which fields you get depends on the data source and the record.

Step 5

Apply your own thresholds

Proceed, send the case to a reviewer, or request a fresh capture. Keep the decision and the reason for it in your audit trail.

Industries

Where teams use Face Match Verification API

These sectors build the check into a decision they already make.

  • Banks, lending and NBFCs

    Match the applicant selfie to the ID photo before disbursal

  • Insurance

    Check a claimant against the policyholder record before a claim moves

  • Fintech and payment providers

    Step-up checks on device changes and account recovery

  • Logistics and fleet

    Confirm the driver starting a shift matches the license on file

  • Staffing and gig platforms

    Shift-start checks that deter account renting and sharing

  • Telecom and retail networks

    Verify distributors and store staff at the point of sale

What is face match?

Face match compares two face images to judge whether they show the same person. One is captured at the moment of the check, such as a selfie during onboarding or a frame from a video session. The other is a reference the business already trusts: a document photograph, an enrollment photo, or an image in the customer record.

The result is a similarity signal about two images. It settles nothing about who someone is. You read it next to the document and record checks your journey already runs.

How a face match API works

An API turns that comparison into a step inside software you already run. Instead of a reviewer holding a document photo beside a selfie, your application sends both images and gets a structured result it can route on.

That matters where the same decision repeats: a lender opening applications daily, a delivery platform activating riders weekly, a marketplace re-checking sellers at a payout change. The outcome no longer turns on who picked up the file.

The two images a face comparison needs

Every request needs a captured image and a reference image, and the condition of both decides how useful the result is. Reference photos lifted from scanned documents are often small, textured, or years older than the person at the camera. Phone captures can carry glare, motion blur or heavy compression.

A response can carry a similarity indication and image-quality signals that explain why a comparison was weak. The exact fields depend on the data source, the record and your service contract. A pair that cannot be compared responsibly may be declined.

What a face comparison cannot tell you

A strong similarity result says the two images look like the same person. It says nothing about how the captured image reached you, because the comparison never sees the camera. A printed photograph, a screen held to the lens, or a stored file sent in place of a fresh capture can all compare well against a document photo.

The separate Face Liveness service is there to narrow that gap, and the order matters: check the capture first, compare it second. Where liveness is not part of a journey, read the result as weaker evidence and lean harder on the checks around it.

Decisions face match supports, by industry

  • Banks, lending and NBFCs: tie the application to the person on the submitted PAN card or driving license, then look again at disbursal.
  • Insurance: put a check between a claim and its payout, and support proof-of-life reviews on long-running pensions and annuities.
  • Fintech and payment service providers: verify the signatory during merchant onboarding, and step up when an account is reached from an unfamiliar device.
  • Marketplaces: hold a seller account to the identity behind it, including at a payout change.
  • Logistics and fleet: establish at shift start that the person about to drive is the one enrolled against the license on file, which is where substitution tends to happen.
  • Staffing and gig platforms: check the worker when a shift opens, to make a rented or shared account harder to keep hidden.
  • Telecom and retail networks: check whoever activates a connection at the counter, which makes it harder to raise a subscription on someone else's documents.
  • Travel, hospitality and real estate: match a guest at check-in to the document given at booking.

Designing a face check into your journey

Four decisions shape the outcome more than any later tuning:

  • Choose which reference image is authoritative for each journey: the document photo, the enrollment photo or the customer record.
  • Put the capture behind a guided step with framing and lighting prompts.
  • Fix your thresholds before launch and record why each one sits where it does, to keep a later move deliberate.
  • Define the route for people a photo cannot resolve.

Running face match next to your other checks

Face match works best as one gate in a sequence, before anything irreversible. Send weak comparisons to a review queue with both images and the reason attached.

Sibling resemblance, aged photos, spectacles, face coverings and poor scans all produce genuine borderline cases. A fresh capture resolves more of them than a retry.

A face image is personal data about an identifiable person. Collect it only for a purpose the person has been told about and has agreed to. Record consent before the capture, keep it with the case, and honor a withdrawal.

Use the comparison only for the authorized purpose, and keep images no longer than that purpose needs.

A similarity result should not be the sole basis for refusing someone a service. Provide a human review path and a way to contest an outcome, and do not reuse onboarding images for any secondary purpose the person never agreed to.

FAQ

Common questions

What teams ask before they integrate Face Match Verification API.

An interface that compares two face images inside your own software. Your application sends a captured image and a reference image, and receives a structured similarity result. You can use it in an onboarding, re-verification or review workflow, instead of asking a person to compare the photos by hand.

Related

More in Face & Biometric Verification

Aadhaar, PAN, Voter ID, passport and driving licence checks, face match and liveness, and ID document OCR.

Browse Identity & KYC APIs
Get started

Add Face Match Verification API to your workflow

Tell us how you plan to use it. Our team sets up API access, agrees your pricing and takes you through onboarding.