> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dojah.io/llms.txt
> Use this file to discover all available pages before exploring further.
# CAC Lookup: Verify Nigerian Companies
> Fetch company details from CAC by name or RC number. Confirm registration, directors, and status in one API call.
There are two payload responses for this endpoint based on the details returned:
* **Basic**
* **Advance**
## CAC Basic
### Request
```http [GET] theme={null}
{{baseUrl}}/api/v1/kyc/cac/basic
```
### Header
| Header | Type | Description |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `` not `Bearer ` |
### 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
```json Response theme={null}
{
"entity": {
"company_name": "JOHN DOE LIMITED",
"type_of_company": "BUSINESS_NAME",
"status": "Not Active",
"rc_number": "1234567",
"business_number": "1234567",
"state": "Lagos",
"city": "Lagos",
"lga": "Kosofe",
"business": "7a666454-8ce0-44e2-ac32-3e8cb04b6b72"
}
}
```
### 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 directors
### Request
```http [GET] theme={null}
{{baseUrl}}/api/v1/kyc/cac/advance
```
### Header
| Header | Type | Description |
| ------------- | ------ | --------------------------------------------------------------------------------------------------- |
| AppId | string | Create an app to get your app ID on dashboard [here](https://app.dojah.io/developers/configuration) |
| Authorization | string | Private/secret key. Use `` not `Bearer ` |
### 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
```json [200] theme={null}
{
"entity": {
"company_name": "JOHN DOE LIMITED",
"rc_number": "1234567",
"address": "John doe street opposite dunamis church ",
"state": "Plateau",
"city": "Jos Town (Capital)",
"lga": "Jos south",
"email": "abc@gmail.com",
"type_of_company": "BUSINESS_NAME",
"date_of_registration": "2024-07-19T08:00:06.224+00:00",
"nature_of_business": null,
"share_capital": null,
"share_details": {},
"affiliates": [
{
"first_name": "JOHN",
"last_name": "MUSA",
"email": "abc@gmail.com",
"address": "John Doe Road",
"state": "Plateau",
"city": "Jos North",
"lga": "Jos",
"occupation": null,
"phone_number": "+2348132464910",
"gender": "MALE",
"date_of_birth": "1995-08-03T00:00:00.000+00:00",
"nationality": "Nigeria",
"affiliate_type": "PROPRIETOR",
"affiliate_category_type": "individual_proprietor",
"country": "NIGERIA",
"id_number": null,
"id_type": null
}
]
}
}
```
### 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`