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.

Enterprise Rails • Nigeria (CAC)

Corporate Verification

Securely verify business registration details directly from the official Corporate Affairs Commission database. Access core metadata or deep-dive into shareholder and director profiles via our sovereign digital rails.

Authentication

All requests require a Bearer Token. Unauthorized requests will return a 401.

Authorization: Bearer YOUR_API_KEY

Implementation • Cross-Platform Samples

Code Samples

Use these production-ready snippets to connect your application to the LumiID sovereign rails. Replace YOUR_API_KEY with the secret key from your dashboard.

import requests

url = "https://api.lumiid.com/v1/ng/cac-basic/"
headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
}
payload = {
  "rc_number": "1234567"
}

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

const axios = require('axios');

const url = "https://api.lumiid.com/v1/ng/cac-basic/";
const headers = {
  "Authorization": "Bearer YOUR_API_KEY",
  "Content-Type": "application/json"
};
const data = { rc_number: "1234567" };

axios.post(url, data, { headers })
    .then(res => console.log(res.data))
    .catch(err => console.error(err));

<?php
$url = "https://api.lumiid.com/v1/ng/cac-basic/";
$headers = [
  "Authorization: Bearer YOUR_API_KEY",
  "Content-Type: application/json"
];
$payload = json_encode([
  "rc_number" => "1234567"
]);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
echo $response;
?>

curl -X POST https://api.lumiid.com/v1/ng/cac-basic/ \
     -H "Authorization: Bearer YOUR_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
  "rc_number": "1234567"
}'

Integration Advice

01.
Timeouts: Set your client timeout to at least 15 seconds. Government registries can occasionally experience latency.
02.
Retry Logic: Implement exponential backoff for 500 series errors.

Quick Validation

All successful responses return a request_id. We recommend logging this ID in your local database alongside the registration record for future audit trails.

Post /v1/ng/cac-basic/

Basic Lookup

Returns essential business registration data including RC number, status, and head office location.

Request Body

{
  "rc_number": "1234567"
}

Sample Response (Basic)

{
  "success": true,
  "code": "CAC_VERIFIED",
  "message": "CAC verification successful",
  "summary": {
    "verified": true,
    "verification_type": "CAC",
    "provider": "LumiID",
    "confidence_score": 1.0
  },
  "data": {
    "rcNumber": "1234567",
    "companyName": "LUMIERE TECHNOLOGIES",
    "status": "ACTIVE",
    "registrationDate": "2022-08-04T15:05:12.383+00:00",
    "headOfficeAddress": "block 8, adeola odeku street, victoria island, lagos",
    "branchAddress": "",
    "city": "",
    "state": "",
    "lga": "",
    "companyType": "",
    "companyEmail": "john.doe@gmail.com",
    "classification": "Business",
    "natureOfBusiness": "",
    "shareCapital": 0,
    "shareCapitalInWords": "",
    "affiliates": 2
  },
  "meta": {
    "request_id": "req_a3f9c21d9b4e",
    "timestamp": "2025-12-27T17:50:46.123456Z"
  }
}

Post /v1/ng/cac-premium/

Premium Lookup (KYB+)

Our deep-intelligence endpoint. Access full shareholder details, UBO info, and PSC (Persons with Significant Control) data.

Sample Response (Premium)

{
    'success': True, 
    'code': 'CAC_VERIFIED', 
    'message': 'CAC verification successful', 
    'summary': {
      'verified': True, 
      'verification_type': 'CAC', 
      'provider': 'LumiID', 
      'confidence_score': 1.0
    }, 
    'data': {
      'state': '', 
      'headOfficeAddress': 'block 8, adeola odeku street, victoria island, lagos', 
      'status': 'ACTIVE', 
      'city': '', 
      'companyEmail': 'john.doe@gmail.com', 
      'rcNumber': '1234567', 
      'classification': 'Business', 
      'branchAddress': '', 
      'registrationDate': '2023-06-04T15:05:12.383+00:00', 
      'companyName': 'LUMIERE TECHNOLOGIES', 
      'lga': '', 
      'companyType': '', 
      'affiliates': 2, 
      'shareCapital': 0, 
      'shareCapitalInWords': '', 
      'natureOfBusiness': '', 
      'affiliatesData': [
      {
        'surname': 'UGBA', 
        'firstname': 'JOSEPH', 
        'othername': '', 
        'email': 'josephugba@gmail.com', 
        'phoneNumber': '7049934545', 
        'gender': 'MALE', 
        'formerNationality': '', 
        'city': 'RING ROAD, IBADAN', 
        'occupation': 'Legal Practitioner', 
        'formerName': '', 
        'corporationName': '', 
        'regNumber': '', 
        'state': 'OYO', 
        'numSharesAlloted': 0, 
        'typeOfShares': '', 
        'dateOfBirth': '1978-03-17T23:00:00.000+00:00', 
        'dateOfAppointment': '2022-08-04T15:05:14.733+00:00', 
        'status': 'ACTIVE', 
        'formerSurname': '', 
        'formerFirstName': '', 
        'formerOtherName': '', 
        'identityNumber': '93683433880', 
        'otherDirectorshipDetails': '', 
        'lga': 'Ibadan South West', 
        'isCorporate': False, 
        'nationality': 'NIGERIA', 
        'address': 'HIGH COURT ROAD', 
        'streetNumber': '21', 
        'isChairman': False, 
        'isDesignated': False, 
        'postcode': '', 
        'formerNameType': '', 
        'affiliateType': {
          'name': 'PRESENTER'
        }, 
        'affiliateCountry': {
          'name': 'NIGERIA'
        }, 
        'companyType': '', 
        'shareCapital': 0, 
        'shareCapitalInWords': '', 
        'affiliatesResidentialAddress': {
          'country': 'NIGERIA', 
          'state': 'OYO', 
          'lga': 'Ibadan South West', 
          'city': 'RING ROAD, IBADAN', 
          'address': 'HIGH COURT ROAD', 
          'streetNumber': '21', 
          'postcode': '', 
          'hideResidentialAddress': False, 
          'affiliateType': ''
        }, 
          'affiliatesPscInformation': {
            'taxResidencyOrJurisdiction': '', 
            'legalForm': '', 
            'register': '', 
            'governingLaw': '', 
            'dateOfPsc': '', 
            'pscHoldsSharesOrInterest': False, 
            'pscHoldsSharesOrInterestPercentageHeldDirectly': 0, 
            'pscHoldsSharesOrInterestPercentageHeldIndirectly': 0, 
            'pscVotingRights': False, 
            'pscVotingRightsPercentageHeldDirectly': 0, 
            'pscVotingRightsPercentageHeldIndirectly': 0, 
            'pscRightToAppoints': False, 
            'pscSignificantInfluence': False, 
            'pscExeriseSignificantInfluence': False
          }, 
            
      }
    }
  }