Skip to content

Published services, current details, and clear categories.

Explore APIs

Face Liveness Detection API

Check whether a submitted selfie or capture came from a live person, not a photo, screen or recording. Use the result to decide whether the session continues.

challenges issued liveBlinkeyes close and reopenTurn lefthead yaws, then centresHold steadyframe settles and staysone capture, no comparisonLIVELIVE CAPTURE CONFIRMEDchallenges answered in order · single subject
Request and response

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

You send

A selfie image or short capture collected by your own application

You receive

A liveness assessment your workflow can act on

Coverage
Selfie and short captures collected in your own app or web flow
Typical users
Lending, insurance, fintech, gig platforms, telecom
Coverage note
Supported capture modes and formats depend on the selected service contract
Overview

What you can do with the Face Liveness Detection API

A face liveness check assesses whether the face in a submitted capture belongs to a person who was actually present. The alternative is a printed photograph, a face on a screen, a replayed video or a mask held up to the camera. The question is narrow on purpose. Liveness does not say who the person is, which is what a face match does. Remote onboarding flows generally use both to establish that a real person is present and that the person matches the identity document on file. Through an API the check runs inside your own capture flow and returns an assessment your workflow can act on. Capture conditions affect what can be assessed, and the detail returned may vary by capture, data source and record. Build a retry path and a review queue into the design.

  • Photos, screens and masks are what it looks for

    The check assesses whether the capture came from a person actually present. A printed photograph, a face on a screen, a replayed video and a mask held to the camera are the cases it catches. It is the assumption every other remote identity check depends on.

  • How it differs from a face match

    Face match compares two faces and liveness assesses one capture. A borrowed photograph can pass a match while failing liveness. Remote journeys generally run both: one establishes that a real person is present, the other which person.

  • Passive or prompted capture

    A passive check assesses the capture without asking the customer to do anything. A prompted check asks the customer to perform a simple action during capture. Which modes are available depends on the selected service contract.

  • Designed for real capture conditions

    Lighting, compression, an obscured face, an unstable connection and low-end cameras all affect what can be assessed. The detail returned may vary by capture, data source and record. Send a capture that could not be assessed to a retry.

How it works

The five-step Face Liveness Detection API workflow

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

Step 1

Agree capture modes and volumes

Start with Get API and describe the journey you are protecting. Available capture modes, supported formats and volumes depend on the selected service contract.

Step 2

Add capture to your app or web flow

Collect the selfie or short capture on the customer's device at the point in the journey where the risk sits. Show a clear notice about what you capture and why.

Step 3

Submit the capture from the live session

Your application sends the capture in a format and mode the service contract supports, from the same session the customer is in.

Step 4

Read the liveness assessment

The service returns an assessment your workflow can act on, along with the detail available for that capture.

Step 5

Continue, retry or send to review

Map each outcome to a defined next step. Continue the journey, offer a guided retry where the capture could not be assessed, or route the session to human review.

Industries

Where teams use Face Liveness Detection API

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

  • Lending and NBFC

    Confirm a live applicant before a remote onboarding step

  • Insurance

    Live capture on a remote proposal or claim intimation

  • Fintech and PSP

    Step-up check before a high-risk account action

  • Staffing and gig platforms

    Shift-start check against shared accounts

  • Logistics and fleet

    Driver identity check at vehicle handover

  • Telecom

    Live capture in a remote self-service activation journey

What is a face liveness check?

A face liveness check assesses whether the face in a submitted capture belongs to a person who was actually present. The alternative is a printed photograph, a face displayed on a screen, a replayed video or a mask held up to the camera.

The question is narrow on purpose. Liveness does not establish who the person is. It assesses whether what the camera captured behaves like a live human being, which is the assumption every other remote identity check quietly depends on.

Face liveness and face match answer different questions

Face match compares two faces and reports how similar they are. Face liveness looks at one capture and assesses whether a live subject produced it.

A borrowed photograph can pass a match check while failing a liveness check, and a live capture of the wrong person does the opposite. Most remote journeys use both: liveness to establish that a real person is present, and a match to establish which person.

How the face liveness API works

The check runs inside your own capture flow. Your application collects the selfie or short capture on the customer's device, submits it, and receives an assessment it can act on without a person reviewing every session.

The check may be passive or prompted, depending on the selected service contract. A passive check assesses the capture without asking the customer to do anything, which keeps the journey shorter. A prompted check asks the customer to perform a simple action during capture, and gives your flow something explicit to evaluate.

The capture your app collects and sends

The check starts from a capture your own application collects: a selfie image or a short capture, in the formats and capture modes your service contract supports. What comes back is an assessment your workflow can act on, and the detail returned with it may vary by capture, data source and record.

Poor lighting, a compressed upload, a partly obscured face, an unstable connection or a low-end camera all reduce what can be assessed. A capture that could not be assessed is different from one that failed, and a flow that treats them alike turns away customers it should have retried.

Where a liveness check earns its place

  • Lending and NBFCs confirm a live applicant before a remote onboarding or disbursal step, where nobody sees the borrower in person.
  • Insurance adds a live capture to remote proposal journeys and claim intimation, where a supplied photograph has always been the easy thing to send.
  • Fintech and payment service providers use liveness as a step-up before a high-risk account action, such as a device change or a change to payout details.
  • Staffing, gig platforms, logistics and fleet check at shift start or vehicle handover that the worker on the job is the worker who was onboarded. It is the practical answer to shared accounts.
  • Marketplaces, telecom and travel re-verify a seller after a change of banking details, and support remote activation and unattended self-service check-in.

How to add a liveness check to a customer journey

The design decisions matter more than the integration:

  • Place the check where the risk is: onboarding, a step-up action, or periodic re-verification.
  • Give a clear retry path with guidance. A poor capture should not read as a rejection.

A liveness check is one control and does not act as a perimeter. Treat the result as a signal that raises or lowers confidence, and combine it with your other session controls and the review path you already run.

A face capture is sensitive personal data and belongs in a consent-led flow. Tell the customer what you capture, what you use it for and how long you keep it. Offer a path for anyone who cannot complete a camera step.

Keep captures out of general-purpose storage and logs, restrict who can view them, and remove them when the purpose is served or your retention obligations end.

Availability and supported capture modes depend on the selected service contract. How you use the result stays your organization's responsibility under applicable data protection rules.

FAQ

Common questions

What teams ask before they integrate Face Liveness Detection API.

A capture your own application collects from the customer's device, either a selfie image or a short capture. Use the formats and capture modes the selected service contract supports. The liveness check itself needs no identity document.

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 Liveness Detection 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.