Skip to main content
POST
Verify a business

Authorizations

Authorization
string
header
required

Your secret API key: fc_test_… in test mode, fc_live_… in live mode.

Query Parameters

simulate
string | null

Test keys only: not_found, inactive or cac_search_unavailable (503); with officer names, also lookup_unavailable (503) or insufficient_balance (402). Ignored with a live key.

Body

application/json
number
string
required

The registration number your applicant gave, with or without its prefix: "8911267" or "RC 8911267".

name
string
required

The business name your applicant gave.

type
enum<string> | null

The register. Needed only when the number is in more than one (type_required).

Available options:
BN,
RC,
IT,
LP,
LLP
officers
string[] | null

Optional: up to 10 full names of proprietors, directors or other officers to check against CAC's record. Sending any makes the verification charged; without them it's free.

Response

Successful Response

id
string
required

bver_…

number
string
required
type
enum<string> | null
required

The register the number is in; null when CAC doesn't have it.

Available options:
BN,
RC,
IT,
LP,
LLP
result
enum<string>
required

match: the name is exact, the business is active and every officer you sent matched. partial: the name is close, the business isn't active, or an officer didn't match. no_match: the name is a different business's. not_found: CAC has no business with that number.

Available options:
match,
partial,
no_match,
not_found
checks
V1VerificationChecks · object
required
amount_charged
string
required

What the verification cost, in naira, as a decimal string: "0.00" when it didn't check officers.

transaction_id
string | null
required

The wtx_… business_verification_charge; null when it was free.

created_at
string | null
required
object
string
default:business_verification
Allowed value: "business_verification"