System Upgrade v3.1

Unified Identity Verification

Securely verify identities across African borders using our sovereign data rails. Integrate biometric, corporate, and financial records in a single request.

Premium Security

Liveness Detection

Liveness Detection prevents "spoofing" attacks—where a fraudster uses a photo, video, or mask of another person. By requiring three distinct angles (Center, Left, and Right), our engine ensures the subject is physically present and reactive during the session.

Endpoint Configuration

POST /v1/ng/verify-liveness/

Required Payload

Field	Requirement
center_frame left_frame right_frame	HybridImageField (Required) The 3-way facial capture. Accepts a public URL or Base64 string. These frames are analyzed for depth, texture, and natural movement.
id_number	CharField (Required) The ID number (NIN, BVN, etc.) used to fetch the reference image for matching.
id_type	CharField (Required) The source database to verify against (e.g., `nin`, `vnin`).
risk	ChoiceField (Default: 'high') Sets the sensitivity of the anti-spoofing engine: `low`: Permissive for low-end camera hardware. `medium`: Standard enterprise balance. `high`: Strict validation; rejects low-resolution or high-glare frames.

Supported Government IDs

Digital ID	Supported
NIN	✅
Virtual NIN	✅
Drivers License	✅
Nigerian Passport	✅
Voters Card	❌

Features & Benefits

🎯

High Accuracy & Anti-Fraud

Uses modern facial recognition to compare the customer’s selfie directly with the government database, significantly reducing false positives and identity theft.

⚡

Fast Verification Process

Customers only need to take a selfie. Verification is completed in seconds, reducing friction and minimizing onboarding abandonment rates.

⚙️

Custom Thresholds

Tailor the matching score threshold to meet specific regulatory requirements, operational needs, or unique organizational risk levels.

🛡️

Improved Compliance

Supports compliance with KYC, AML, and digital identity regulations by utilizing approved, government-backed identity sources.

Example Request

import requests
                  import json

                  url = "https://api.lumiid.com/v1/ng/verify-liveness/"

                  payload = json.dumps({
                    "id_type": "NIN",
                    "id_number": "63184876213",
                    "center_frame": "data:image/jpeg;base64,...",
                    "left_frame": "data:image/jpeg;base64,...",
                    "right_frame": "data:image/jpeg;base64,...",
                    "risk": "high",
                  })

                 
                  headers = {
                    'Authorization': 'Bearer Your-Secret-Key',
                    'Content-Type': 'application/json'
                  }

          response = requests.post(url, headers=headers, data=payload)
          print(response.text)

const axios = require('axios');

              const data = JSON.stringify({
                "id_type": "NIN",
                "id_number": "63184876213",
                "center_frame": data:image/jpeg;base64,...",
                "left_frame": data:image/jpeg;base64,...",
                "right_frame": data:image/jpeg;base64,...",
                "risk": "high"
              });

              const config = {
                method: 'post',
                url: 'https://api.lumiid.com/v1/ng/verify-liveness/',
                headers: { 
                  'Authorization': 'Bearer Your-Secret-Key', 
                  'Content-Type': 'application/json'
                },
                data : data
              };

              axios.request(config)
              .then((response) => console.log(JSON.stringify(response.data)))
              .catch((error) => console.log(error));

              
                curl -X POST https://api.lumiid.com/v1/ng/verify-liveness/ \\
                -H "Authorization: Bearer Your-Secret-Key" \\
                -H "Content-Type: application/json" \\
                -d '{
                  "id_type": "NIN",
                  "id_number": "63184876213",
                  "center_frame": "data:image/jpeg;base64,...",
                  "left_frame": "data:image/jpeg;base64,...",
                  "right_frame": "data:image/jpeg;base64,...",
                  "risk": "high"
                }
                '

Response Sample 200 OK

{
            "success": true,
            "code": "SUCCESS",
            "message": "Verification completed successfully.",
            "summary": {
              "verified": true,
              "verification_type": "FACE_MATCH",
              "provider": "LumiID"
            },
            "data": {
              "verification_status": "VERIFIED",
              "match_result": "CONFIRMED",
              "confidence": {
                "score": 0.9995,
                "threshold": 0.85,
                "status": "STRONG_MATCH"
              },
              "identity": {
                "nin": "63184876213",
                "firstname": "Bunch",
                "lastname": "Dillon",
                "gender": "m",
                "photo": "/9j/4AAQSk...[Base64_String]",
                "birthdate": "06-01-1974",
                "residence": {
                  "state": "FCT Abuja"
                }
              }
            },
            "meta": {
              "request_id": "req_aad8f3659faf",
              "timestamp": "2026-02-20T03:58:56Z"
            }
          }

Use Case

Face Liveness Detection over an API is a powerful tool for applications that require secure authentication, such as online banking, identity verification, and access control. It is essential to ensure that the facial recognition system used is accurate, secure, and complies with data privacy regulations