There are two payload responses for this endpoint based on the details returned:
- Basic
- Advance
CAC Basic
Request
[GET]
Header
| Header | Type | Description |
|---|---|---|
| AppId | string | Create an app to get your app ID on dashboard here |
| Authorization | string | Private/secret key. Use <key> not Bearer <key> |
Query parameter
| Parameter | Type | Description | Required |
|---|---|---|---|
| rc_number * | string | RC number (Registration Number) is a unique identification number assigned to a business by the Corporate Affairs Commission (CAC) in Nigeria. | required |
| company_type * | string | type of company, values are BUSINESS_NAME, COMPANY, INCORPORATED_TRUSTEES, LIMITED_PARTNERSHIP, LIMITED_LIABILITY_PARTNERSHIP | required |
Sample response
Response
Response Fields (CAC Basic)
| Field | Type | Description |
|---|---|---|
| entity | object | Contains the CAC basic lookup response data |
| entity.company_name | string | Registered name of the company |
| entity.type_of_company | string | Type of company registration (e.g., BUSINESS_NAME, COMPANY) |
| entity.address | string | Registered address of the company |
| entity.status | string | Current registration status of the company (e.g., Active, Not Active) |
| entity.rc_number | string | RC number assigned by the Corporate Affairs Commission |
| entity.business_number | string | Business number assigned to the company |
| entity.email | string | Registered email address of the company |
| entity.state | string | State where the company is registered |
| entity.city | string | City where the company is registered |
| entity.lga | string | Local government area of the company |
| entity.business | string | Unique business identifier |
CAC Advance
This endpoint allows one to resolve premium CAC details using RC number. It returns information on companyβs board of directorsRequest
[GET]
Header
| Header | Type | Description |
|---|---|---|
| AppId | string | Create an app to get your app ID on dashboard here |
| Authorization | string | Private/secret key. Use <key> not Bearer <key> |
Query parameter
| Parameter | Type | Description | Required |
|---|---|---|---|
| rc_number * | string | RC number (Registration Number) is a unique identification number assigned to a business by the Corporate Affairs Commission (CAC) in Nigeria. | required |
| company_type * | string | type of company, values are BUSINESS_NAME, COMPANY, INCORPORATED_TRUSTEES, LIMITED_PARTNERSHIP, LIMITED_LIABILITY_PARTNERSHIP | required |
Sample response
[200]
Response Fields (CAC Advance)
| Field | Type | Description |
|---|---|---|
| entity | object | Contains the CAC advance lookup response data |
| entity.company_name | string | Registered name of the company |
| entity.rc_number | string | RC number assigned by the Corporate Affairs Commission |
| entity.address | string | Registered address of the company |
| entity.state | string | State where the company is registered |
| entity.city | string | City where the company is registered |
| entity.lga | string | Local government area of the company |
| entity.email | string | Registered email address of the company |
| entity.type_of_company | string | Type of company registration (e.g., BUSINESS_NAME, COMPANY) |
| entity.date_of_registration | string | Date and time the company was registered (ISO 8601 format) |
| entity.nature_of_business | string | null | Description of the companyβs business activities |
| entity.share_capital | string | null | Registered share capital of the company |
| entity.share_details | object | Details of the companyβs share structure |
| entity.affiliates | array | List of individuals affiliated with the company (directors, proprietors, etc.) |
| entity.affiliates[].first_name | string | First name of the affiliate |
| entity.affiliates[].last_name | string | Last name of the affiliate |
| entity.affiliates[].email | string | Email address of the affiliate |
| entity.affiliates[].address | string | Residential address of the affiliate |
| entity.affiliates[].state | string | State of residence of the affiliate |
| entity.affiliates[].city | string | City of residence of the affiliate |
| entity.affiliates[].lga | string | Local government area of the affiliate |
| entity.affiliates[].occupation | string | null | Occupation of the affiliate |
| entity.affiliates[].phone_number | string | Phone number of the affiliate |
| entity.affiliates[].gender | string | Gender of the affiliate |
| entity.affiliates[].date_of_birth | string | Date of birth of the affiliate (ISO 8601 format) |
| entity.affiliates[].nationality | string | Nationality of the affiliate |
| entity.affiliates[].affiliate_type | string | Role of the affiliate in the company (e.g., PROPRIETOR, DIRECTOR) |
| entity.affiliates[].affiliate_category_type | string | Category classification of the affiliate (e.g., individual_proprietor) |
| entity.affiliates[].country | string | Country of the affiliate |
| entity.affiliates[].id_number | string | null | Identification number of the affiliate |
| entity.affiliates[].id_type | string | null | Type of identification document provided |
Test Credentials for Sandbox
Kindly use this Test RC Number in sandbox Environment RC Number =1261103, 14320749