How does this fit into Video KYC?

Face match and liveness are the biometric core of V-CIP: they confirm the customer on the video matches their ID and is physically present, alongside the geotagging and recording V-CIP requires.

Is the biometric check consent-first and auditable?

Yes. Every call captures a purpose-bound consent artifact and writes to a tamper-evident audit log, with PII handled under a DPDP-ready architecture.

Face Match & Liveness Detection API

Identity · Biometrics

Match a customer's live selfie against their ID-document photo and confirm a real person is present, the biometric check behind compliant remote onboarding.

Book Demo

Read API docs

request · /v1/kyc/face/match

Live selfie

ID document

Send request

api · POST /v1/kyc/verify

POST /v1/kyc/verify

Authorization: Bearer sk_live_••••

{ "pan": "XXXXXXXXXX", "consent_artifact": "ca_••••" }

OKVerified

{

"status": "verified",

"name_match": "high",

"dpdp_purpose_code": "LOAN_KYC",

"consent": "sealed"

}

Overview

What the Face Match & Liveness API Does

FinHub's Face Match & Liveness API compares a live selfie to the photo on an identity document and returns a similarity score, while a liveness check detects spoofing attempts such as printed photos, screens or masks. Together they confirm the person onboarding is who they claim to be and is physically present: the biometric layer that underpins Video KYC (V-CIP) and self-serve onboarding, with consent capture and an audit trail on every call.

Inputs

Live selfie / video frame
ID document photo
Consent artifact ID

Returns

Face-match score (0–1)
Liveness result (pass/fail)
Spoof-attempt signals

POST /v1/kyc/face/match

How it works

Three Steps to a Verified Result

Capture the selfie

The customer takes a live selfie (or short video) with their consent recorded as an artifact.

We match and check liveness

FinHub compares the selfie to the ID photo and runs a liveness check to detect printed photos, screens or masks.

Get a biometric decision

Receive a match score and liveness result so you can auto-approve clean matches and route the rest to review.

Use cases

Where Teams Use Face Match & Liveness

Biometric step in Video KYC (V-CIP)
Self-serve digital onboarding
Step-up authentication for high-risk actions
Preventing impersonation and spoofing fraud

FAQ

Face Match & Liveness API, FAQs

Common questions about FinHub's Face Match & Liveness API.

Face match compares a live selfie to the ID-document photo and returns a similarity score. Liveness detection confirms a real, present person, not a printed photo, screen replay or mask. You typically use both together.

More verification APIs