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.

Face Match

Unified LumiID's Face Match service enables businesses to verify a customer’s identity by comparing their selfie image to the image stored in official government databases. Using advanced facial recognition technology, the service produces a confidence score indicating the likelihood of a match.

Supported Government IDs

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

Verification Request

POST /v1/ng/verify-face/

Body Parameters

Parameter	Type / Description
id_type Required	enum Must be one of: `nin`, `vnin`, `nigerian_passport`, `bvn`, `drivers-license`.
id_number Required	string The unique identification number corresponding to the `id_type`.
photo_url or photo_base64 Required	string Provide either a secure, publicly accessible URL to the selfie image, or a raw Base64 encoded string of the image.
threshold Optional	string \| float Minimum confidence score required to accept a match. Allows customization for different risk levels. Default: `75`
level Optional	string Determines the strictness of the check: • `standard`: Basic 1:1 comparison. • `advance`: Includes passive liveness detection to ensure the selfie is a real live person, not a photo of a photo.

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.test:8000/v1/ng/verify-face/"

                  payload = json.dumps({
                    "id_type": "NIN",
                    "id_number": "63184876213",
                    "photo_url": "https://your-server.com/testface.jpg",
                    "level": "advance",
                    "threshold": "85"
                  })

                  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",
                "photo_url": "https://your-server.com/testface.jpg",
                "level": "advance",
                "threshold": "85"
              });

              const config = {
                method: 'post',
                url: 'https://api.lumiid.test:8000/v1/ng/verify-face/',
                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.test:8000/v1/ng/verify-face/ \\
                -H "Authorization: Bearer Your-Secret-Key" \\
                -H "Content-Type: application/json" \\
                -d '{
                  "id_type": "NIN",
                  "id_number": "63184876213",
                  "photo_url": "https://your-server.com/testface.jpg",
                  "level": "advance",
                  "threshold": "85"
                }
                '

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 Matching 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