Initiate Business Verification

POST/accounts/:id/businesses/verifications

Initiate the business verification process.

Body Parameters
registration_type
string
required
the registration type, BN, RC, IT
registration_number
string
required
the business registration number
business_legal_name
string
required
the business legal name
business_address_line_1
string
required
the business address
business_address_state
string
required
the business address state
industry_id
string
required
the Industry ID of the business (see Get Industries API for available values)
directors_info
array
required
a list of objects containing the directors info

Directors Info

Although the directors_info field accepts a list of directors, currently only one director object is expected. Each directors_info object must include the following fields:

Info Key
Full name (i.e., first name and last name) name
BVN bvn

Test Values

In the sandbox environment, use the following test values to simulate the different test scenarios.

Case (field) Value Description
Valid Registration Number registration_number 0000008 For cases where a business registration number is valid.
Invalid Registration Number registration_number 0000000 For cases where a business registration number is invalid.
Director Not Found registration_number 0000001 For cases where the submitted director information is not found in CAC records.
Business Name Mismatch registration_number 0000009 For cases where the submitted business name does not match the one in CAC records.
Director EDD Required registration_number 0000002 For cases where an Extended Due Diligence (EDD) form is required for the submitted director.
Director BVN Name Match directors_info[0].bvn 22222222281 For cases where the submitted director’s name match the name on their BVN.
Director BVN Name Mismatch directors_info[0].bvn 22222222291 For cases where the submitted director’s name does not match the name on their BVN.
Note
The registration_type field indicates the type of CAC registration. Use BN if the registration number begins with BN (Business Name), RC if it begins with RC (Registered Company), and IT if it begins with IT (Incorporated Trustees).