New One API for compliant identity and risk decisions across Africa
Biometric identity verification

Verify the person,
not just the document.

Compare a live selfie with a government ID using LumiID’s AI-powered biometric face verification API—then stop spoofing and deepfakes with passive liveness detection.

Start building Talk to an expert

REST API · Base64 image input · Clear JSON responses · Secure requests

VERIFICATION SESSION LM-2481-AF
GOVERNMENT ID Portrait on a government ID
LIVE SELFIE
Live selfie being captured
98.7

Identity match confirmed

face_match: true  ·  liveness: passed
image_quality: high  ·  response: completed

Built for trust

Identity infrastructure for high-stakes moments

Banks & fintechs
Fraud prevention
KYC biometrics
Enterprise identity
Transaction monitoring
POST /v1/assets/biometrics/face-match
200 OK
Selfie image

selfie_image

1:1 COMPARISON

ID face image

id_face_image

MATCH

0.987

decision: truefaces_detected: 2quality: sufficient
Face Match API

Selfie-to-ID verification, resolved in seconds

Confirm that the face in a live selfie belongs to the same person shown on a government ID. LumiID performs a precise 1:1 biometric face comparison and returns a usable decision—not a black box.

  • Receive a confidence score, match decision, and verification metadata.
  • Use in digital KYC, account recovery, authentication, and high-risk actions.
  • Evaluate face and image quality before continuing the workflow.
Explore Face Match API
Passive Liveness Detection API

Know there is a real person behind the selfie

Verify that a selfie belongs to a live person from one Base64-encoded image—without asking customers to blink, turn, or follow intrusive challenges.

  • Detect presentation attacks, screen replays, masks, and deepfake signals.
  • Return a liveness result with face-analysis and image-quality details.
  • Add anti-fraud protection without adding customer friction.
View liveness docs
PASSIVE · SINGLE IMAGE LIVE
Live selfie analysed for liveness
sharpness  0.94lighting  good

LIVENESS RESULT

Passed

confidence · high

Printed photoCLEAR
Screen replayCLEAR
Face maskCLEAR
Deepfake signalsCLEAR

IMAGE INPUT

data:image/jpeg;base64,/9j/4AAQ...

How it works

From selfie capture to identity decision in three steps

Keep your product experience simple while LumiID handles the biometric intelligence behind the scenes.

01

Send two images

Submit the ID portrait and live selfie as Base64-encoded images through a secure API request.

selfie_image + id_face_image

02

Analyze identity signals

LumiID detects faces, evaluates image quality, compares biometric features, and checks liveness.

face · quality · liveness

03

Make the right decision

Use clear match, confidence, and risk metadata to approve, review, or reject your customer journey.

approve · review · reject

Built for developers

One clean API. Decisions your product can use.

Integrate selfie-to-ID verification and passive liveness into your existing identity stack. Predictable endpoints and structured responses keep implementation straightforward.

  • Use familiar HTTPS requests and predictable JSON responses.
  • Orchestrate biometrics with LumiID KYC, KYB, AML, and fraud checks.
  • Build decision logic from transparent verification metadata.
cURL REST JSON Base64
Read the API docs 
curl --request POST \
  --url https://api.lumiid.africa/v1/assets/biometrics/verify \
  --header 'Authorization: Bearer sk_test_••••' \
  --header 'Content-Type: application/json' \
  --data '{
    "selfie_image": "data:image/jpeg;base64,/9j/4AAQ...",
    "id_face_image": "data:image/jpeg;base64,/9j/2wCEA...",
    "checks": ["face_match", "passive_liveness"]
  }'
200 RESPONSEapplication/json 
{
  "verification_id": "vrf_01J8LM9Q",
  "status": "completed",
  "face_match": {
    "match": true,
    "confidence": 0.987,
    "quality": "sufficient"
  },
  "liveness": {
    "is_live": true,
    "risk": "low"
  }
}
Built for real-world identity

Biometric verification for every high-trust journey

Use LumiID wherever your business must know that the right person is present, live, and connected to a verified identity.

One infrastructure layer for onboarding, ongoing monitoring, fraud prevention, and step-up verification.

Fintech & digital lending

Verify borrowers and account owners before onboarding, disbursement, or sensitive account changes.

Digital KYCAccount recovery

Banks & payments

Strengthen remote onboarding and step-up authentication across regulated financial journeys.

AML complianceHigh-risk payments

Identity platforms

Add reliable biometric comparison and liveness signals to your own identity orchestration layer.

Embedded APIRisk routing

Healthcare

Confirm patient identity before remote access to records, benefits, and protected care services.

Patient accessBenefits checks

Government services

Make digital public services safer while supporting accessible, remote citizen verification.

Citizen identityService access

Enterprise & workforce

Verify employees, contractors, and administrators during enrollment and account recovery.

Workforce checksPrivileged access
Security by design

Identity infrastructure for controlled, auditable decisions

Build KYC biometrics and anti-fraud checks into workflows that protect customer data, support human review, and give your risk team clear evidence.

LumiID helps teams implement identity controls. Your legal and compliance teams remain responsible for configuring workflows to meet applicable requirements.

Protected in transit

Use authenticated API requests and encrypted transport for sensitive identity payloads.

Data-minimizing workflows

Send only the images and context required for the verification decision.

Traceable decisions

Reference verification IDs and structured metadata in review and audit workflows.

Your risk policy

Combine confidence, quality, liveness, and fraud signals in rules that fit your business.

BEYOND BIOMETRICS

KYC

KYB

AML screening

Fraud checks

Transaction monitoring

Frequently asked questions

Questions about face verification and liveness

Understand how LumiID supports secure identity verification without slowing down your customer journey.

Visit developer docs

A biometric face verification API compares facial characteristics across two images to determine whether they belong to the same person. LumiID’s Face Match API performs a 1:1 comparison between a selfie and an ID portrait, then returns a match decision, confidence score, and supporting metadata.

You send a live selfie and the face image from a government ID as Base64-encoded images. LumiID detects the faces, checks image quality, compares the biometric features, and returns a match decision with a confidence score.

Passive liveness detection confirms that a selfie shows a real, present person from a single image. Customers don’t need to blink, turn their head, or follow on-screen prompts.

Yes. Liveness checks look for printed photos, screen replays, masks, and deepfake signals, and return a liveness result with image-quality details you can use in your own risk rules.

Common uses include digital onboarding, account recovery, step-up authentication, high-risk payments, patient access, citizen services, and workforce enrollment.

Yes. Pass both checks in a single request with "checks": ["face_match", "passive_liveness"] and receive one structured response.

Images are sent as Base64-encoded strings, for example data:image/jpeg;base64,..., in a JSON request body.

Build trust into every identity decision

Ready to add biometric verification to your product?

Start with the API or talk with LumiID about an identity and anti-fraud workflow designed for your business.

Start building Talk to an expert