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

Integration Options • API, Dashboard, SDK

Multiple Ways to Verify

Whether you prefer direct API integration, manual dashboard lookups, or a plug-and-play SDK, we have you covered. Choose the method that best fits your workflow and technical resources.

API Access

Use our CAC Lookup API to verify Nigerian businesses by their RC number or company name. You’ll receive key details like company status, registration number, type, and office address directly from CAC’s public records.

Dashboard Lookup

Prefer a no-code option? Run CAC verifications directly from your LumiID SafeOnboard dashboard. Just enter the RC number or company name, and get results instantly. This is perfect for one-off checks or operational support without engineering effort.

SDK Integration (Coming Soon)

Use our SDK for a seamless integration experience with pre-built functions.

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 = {
  "reg_number": "RC1234567"
}

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 = { reg_number: "RC1234567" };

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([
  "reg_number" => "RC1234567"
]);

$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 '{
  "reg_number": "RC1234567"
}'

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

{
  "reg_number": "RC1234567"
}

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
          }, 
            
      }
    }
  }