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.

Global Gateway / v1.1.0

The Unified Rail

POST https://api.lumiid.com/v1/identities/verify/

One endpoint for all sovereign data. Verify CAC, NIN, or BVN by simply adjusting the id_type in your request body.

Core Request Logic

The payload structure is standardized. Use the params object to pass the specific identifier for the selected id_type.

id_type

Identity Switcher Determines the sovereign database to query.

method

Verification Method Defaults to identity. Supports biometric for advanced tiers.

level

Data Depth basic (Default) or advance (UBO/Full Profile).

params

Payload Object Must contain id_number.

import requests

url = "https://api.lumiid.com/v1/identities/verify/"
payload = {
    "country": "NG",
    "id_type": "CAC",
    "level": "advance",
    "params": {
        "id_number": "200002"
    }
}
headers = {"Authorization": "Bearer YOUR_API_KEY"}

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

Live Sample Response

200 OK

{
  "success": true,
  "code": "CAC_VERIFIED",
  "data": {
    "companyName": "DYNAMITE EVENTS SERVICES",
    "rcNumber": "200002",
    "status": "ACTIVE",
    "affiliatesData": [...]
  }
}

System Resilience

400

Invalid Schema

Thrown if id_type is unsupported or the params object is malformed.

401

Auth Failure

Bearer token missing. Ensure your key is active in the LumiID Dashboard.

404

Record Missing

No matching identity found in the sovereign registry (CAC/NIMC/NIBSS).