Overview
Verification tiers
Basic
The Basic tier is designed for standard business verification and merchant onboarding. It returns:- Company name, RC number, and registration status
- Registration date and head office address
- Company email and classification
- Nature of business and share capital
- Count of registered affiliates
Premium
The Premium tier returns everything in Basic, plus detailed corporate ownership and governance information:- Directors, shareholders, and company officers
- Persons with Significant Control (PSC)
- Residential addresses, share allocation, nationality, and appointment dates
Basic endpoint
Use this endpoint for standard business verification and merchant onboarding.
POST /v1/ng/cac-basic/
Base URL: https://api.lumiid.com
Headers
Request body
string
required
The company’s CAC registration number. Include the
RC prefix as issued by the Corporate Affairs Commission.Example: RC1234567Success response
Response fields
boolean
Indicates whether the verification completed successfully.
string
Machine-readable response code (e.g.
CAC_VERIFIED).string
Human-readable response message.
object
High-level verification summary.
object
The verified CAC business record.
object
Request metadata.
Premium endpoint
POST /v1/ng/cac-premium/
The Premium endpoint returns the complete CAC company profile for enhanced business verification, ownership screening, and regulatory compliance. It accepts the same headers and request body as the Basic endpoint.
Additional response fields
The Premium response includes all Basic fields plus anaffiliatesData array on the data object.
array
Complete list of company affiliates, including directors, shareholders, officers, and presenters.
Premium response example
Error codes
Recommended KYB flow
Follow this workflow to achieve the highest level of business assurance before onboarding a company.1
Verify the CAC RC Number
Call
POST /v1/ng/cac-basic/ with the company’s RC number to confirm it is registered and active with the CAC.2
Retrieve the Premium profile (if EDD is required)
Call
POST /v1/ng/cac-premium/ to obtain the full corporate profile, including directors, shareholders, and PSC information, for any company requiring Enhanced Due Diligence.3
Screen directors and shareholders via AML
Run the individuals returned in
affiliatesData through your AML or watchlist screening system to check for sanctions, PEP status, or adverse media.4
Proceed with onboarding
After all checks pass, activate the merchant or business account with a complete audit trail.
This workflow helps you reduce onboarding fraud, detect shell companies, validate legal entities, and satisfy KYB and AML compliance requirements.
Code example
Python
Security and compliance
- All company records are retrieved directly from the Corporate Affairs Commission (CAC).
- All API requests must use HTTPS.
- Every verification includes a unique
request_idfor auditing and troubleshooting. - Handle business information in accordance with applicable data protection and corporate compliance regulations.
- Process Premium corporate ownership information only where there is a lawful business purpose.