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.
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
Explore related APIs
Ready to add Face Match & Liveness to your flow?
Book a demo and see the API return a verified result on your own test data in minutes.