📘 NOTE

There are two payload responses for this endpoint based on the details returned

  • Basic
  • Advance

​
CAC Basic

​
Request

[GET]
{{baseUrl}}/api/v1/kyc/cac/basic
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringprod_sk_1T1eSavlZxy02OT3OWlvbxK4G

​
Query parameter

ParameterTypeDescriptionRequired
rc_number *stringRC number (Registration Number) is a unique identification number assigned to a business by the Corporate Affairs Commission (CAC) in Nigeria.required
company_type *stringtype of company, values are BUSINESS_NAME, COMPANY, INCORPORATED_TRUSTESS, LIMITED_PARTNERSHIP, LIMITED_LIABILITY_PARTNERSHIPrequired

​
Sample response

Response
{
    "entity": {
        "company_name": "JOHN DOE LIMITED",
        "type_of_company": "BUSINESS_NAME",
        "address": "25A James Street Magodo Phase I, Lagos, Nigeria.",
        "status": "Not Active",
        "date_of_registration": "2021-03-18T09:53:20.310+00:00",
        "rc_number": "1234567",
        "business_number": "1234567",
        "email": "ABC@GMAIL.COM",
        "state": "Lagos",
        "city": "Lagos",
        "lga": "Kosofe",
        "business": "7a666454-8ce0-44e2-ac32-3e8cb04b6b72"
    }
}

​
CAC Advance

This endpoint allows one to resolve premium CAC details using RC number, It returns information on company’s board of directors

​
Request

[GET]
{{baseUrl}}/api/v1/kyc/cac/advance

​
Header

HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
Authorizationstringprod_sk_1T1eSavlZxy02OT3OWlvbxK4G

​
Query parameter

ParameterTypeDescriptionRequired
rc_number *stringRC number (Registration Number) is a unique identification number assigned to a business by the Corporate Affairs Commission (CAC) in Nigeria.required
company_type *stringtype of company, values are BUSINESS_NAME, COMPANY, INCORPORATED_TRUSTESS, LIMITED_PARTNERSHIP, LIMITED_LIABILITY_PARTNERSHIPrequired

​
Sample response

[200]
{
    "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": "DOE",
                "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
            }
        ]
    }
}

​
Test Credentials for Sandbox

Kindly use this Test RC Number in sandbox Environment

RC Number = 1261103, 14320749

Was this page helpful?

Validate FIRS TINSelfie Photo ID Verification