Liveness Check API

Confirm a real person is behind every selfie

LumiID's passive liveness check reads texture, geometry, and colour signals from a single selfie to catch photos, screen replays, and deepfakes — no blink, smile, or head-turn challenges required.

Single-frame capture · No active challenges needed

High-assurance authentication

Add biometric confidence to sign-ups, logins, and transaction approvals without extra hardware.

Cut duplicate accounts

Pair liveness with face matching to catch the same person opening multiple accounts under different identities.

Detect spoofing and deepfakes

Printed photos, screen replays, and synthetic faces get flagged before they reach a human reviewer.

What the API checks

One selfie, a full read on who's really there

Liveness Check does more than pass or fail a photo — it returns a full picture of the face captured.

Passive, single-frame capture

Users take one selfie — no blinking, smiling, or turning their head on command, which keeps onboarding fast.

Spoof and replay detection

Texture, screen-glare, and facial-geometry signals combine to flag printed photos, screen replays, and masks.

Rich face attributes

Age range, gender, emotion, eyewear, facial hair, eye and mouth state, and image quality come back with every check.

Face-match ready

Combine with 1:1 face matching to confirm the live selfie belongs to the same person on a submitted ID.

How it works

From selfie to verdict in one request

A single API call takes a base64-encoded selfie and returns a structured liveness and face-attribute result.

  1. 1

    User captures one selfie

    Inside your app or the LumiID SDK, no active challenge or multi-step prompt needed.

  2. 2

    LumiID analyzes the frame

    Texture, geometry, and colour signals are combined into a single liveness probability score.

  3. 3

    You get a clear verdict

    A live/not-live result plus full face attributes land in your system, ready to gate the next step.

POST /api/v1/liveness/check/ { "selfie": "<base64_image>" } // 200 OK { "entity": { "liveness": { "liveness_check": true, "probability": 0.97 }, "face": { "age_range": "25-32", "gender": "female", "emotion": "neutral", "eyes_open": true, "mouth_open": false, "eyeglasses": false, "quality": "high", "bounding_box": { ... } } } }
eyes_open emotion eyeglasses quality

Built to be fast for users, hard to fool for fraudsters

No friction for real users

One selfie beats a multi-step challenge flow, which keeps onboarding and login conversion high.

Signal beyond pass or fail

Face attributes give your risk team more context than a bare liveness verdict alone.

Pairs with the rest of the stack

Combine Liveness Check with KYC Verification and Biometric Verification for a complete, verified view of every user.

Built for your developers

One endpoint, a clear response contract, and sandbox test images so your team can ship in days.

View API documentation

Pricing that fits your stage

Pay for verified checks as you grow, with plans for early-stage products and high-volume platforms alike.

See pricing

Frequently asked questions

What is LumiID Liveness Check?

It's an API that analyzes a single selfie to confirm it was captured from a real, live person rather than a photo, screen replay, mask, or synthetic image.

Is this passive or active liveness detection?

Passive. Users capture one selfie with no blink, smile, or head-turn challenges, which keeps onboarding fast while still detecting spoofing attempts.

What does the API return besides a pass or fail result?

Alongside the liveness result, the response includes face attributes such as age range, gender, emotion, eyewear, facial hair, eye and mouth state, image quality, and the face bounding box.

Can Liveness Check be combined with face matching?

Yes. Liveness Check can be paired with 1:1 face matching to confirm the live selfie belongs to the same person shown on a submitted ID document.

How accurate is the liveness result?

Each selfie is scored with a liveness probability, and a result is classified as live once that score crosses the configured confidence threshold.

Build the future of digital identity with LumiID

Built with cutting-edge identity intelligence to deliver verification, fraud protection, and compliance that scale with you.