Automated KYB for Modern Institutions
Verify legal entities and beneficial owners in seconds. LumiID connects directly to official corporate registries to provide real-time data on company status, registration details, and director profiles.
"id_type": "CAC", "level": "advance", "params": { "rc_number": "RC1234567", "include_directors": true }
API Overview
One Endpoint. Full Corporate Context.
The KYB API sits inside LumiVerify alongside our NIN and BVN checks, so you authenticate once and call one consistent surface for every identity type. Submit a business's RC number or registered name, and the API resolves it directly against the CAC registry — returning status, directors, and incorporation details as structured JSON. No scraping, no manual registry searches, no waiting on a back-office team.
Bearer token via API key
Sent as a Header on every request; scoped per environment (sandbox / live).
Sub-3-second average
Direct registry access — no third-party resellers in the path.
Pay-per-successful-check
Credits are only charged on a confirmed match against the registry.
Features
Deep Corporate
Verification.
LumiID provides more than just a "status check." We provide a full audit trail for AML compliance.
Company Status
Confirm if a business is Active, Inactive, or Dissolved instantly.
Director Profiles
Retrieve full names and roles of all registered directors and shareholders.
Registration Documents
Verify the date of incorporation and official head office address.
Tax Compliance (TIN)
Link corporate entities to verified Tax Identification Numbers automatically.
Code Examples
See the Full Request & Response
A single POST call with an RC number returns the full corporate record. Below is a representative request and the shape of data you'll get back.
curl -X POST https://api.lumiid.com/v1/kyb/verify \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "id_type": "CAC", "level": "advance", "params": { "rc_number": "RC1234567", "include_directors": true } }'
"status": "success", "data": { "rc_number": "RC1234567", "company_name": "Acme Trading Ltd", "registration_status": "Active", "date_of_incorporation": "2019-03-14", "directors": [ { "name": "Jane Doe", "role": "Director" } ] }
Start Verifying Businesses for Free.
Get sandbox access in minutes. Test the KYB API against real CAC-format data before you commit to a plan — no card required.