Business KYC
KYB — Business KYC.
Verify a business end-to-end: CAC lookup, RC number, tax ID, and every named director run through individual KYC — one API, one webhook.
One request
A single call. Real data.
Copy, paste your test key, and get a real response in seconds.
curl -X POST https://api.karverifi.com/v1/verifications/kyb \
-H "Authorization: Bearer kv_test_xxxx" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"rc_number": "RC123456",
"run_director_kyc": true
}'What you get
Everything the compliance team asks for.
CAC-direct lookup
Live pull from the Corporate Affairs Commission — registered name, RC number, status, and filings.
Tax ID resolution
FIRS Tax Identification Number returned alongside — no second call needed.
Per-director KYC fan-out
Every named director runs through individual BVN or NIN verification in parallel.
One rollup decision
A single approved/review/rejected verdict summarises the whole business — plus every underlying check.
Heads up
One call fans out into full KYC per director
When you set `run_director_kyc: true`, we pull the CAC filings, extract every named director, run individual BVN/NIN verification on each, and roll the results up into a single pass/fail decision — delivered on a single webhook.
Response shape
A typical successful response.
{
"id": "ver_01HXKC1KVEBN9YJT4EXAMPLE",
"type": "kyb",
"outcome": "passed",
"created_at": "2026-07-17T09:22:11Z",
"business": {
"rc_number": "RC123456",
"registered_name": "Karrabo Financial Solutions Limited",
"company_type": "private_limited",
"registration_date": "2020-11-04",
"status": "active",
"tax_id": "TIN-01823456-0001",
"registered_address": "85–86 Terrace Wing, Tafawa Balewa Square, Lagos"
},
"directors": [
{
"name": "Adaeze Okoye",
"role": "director",
"kyc": {
"type": "bvn",
"outcome": "passed",
"match_score": 0.98
}
},
{
"name": "Chukwuemeka Nwosu",
"role": "director",
"kyc": {
"type": "bvn",
"outcome": "passed",
"match_score": 0.94
}
}
],
"rollup": {
"directors_total": 2,
"directors_passed": 2,
"decision": "approved"
}
}Questions
Common questions on kyb — business kyc.
The rollup decision flips to `review` (partial failure) or `rejected` (majority failure). You'll see every individual outcome in the response, so your reviewers know exactly which director to escalate.
Ready to ship?
Wire up kyb — business kyc today.
Test in sandbox for free, go live the same afternoon.