Lookup CAC

This endpoint allows developers to fetch CAC information of customers' company/organization.
CAC is a certificate that shows evidence of the company's existence.

πŸ“˜

NOTE

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

  • Basic
  • Advance

CAC Basic

Request

{{baseUrl}}/api/v1/kyc/cac

Headers

Parameter

Type

Description

AppId

string

you would need to create an app to get your app ID

Authorization

string

prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Query Parameters

Parameter Type Description
rc_number * string RC number required
company_name * string name of company required

Response Sample

{
  "entity": {
    "rc_number": "1261103",
    "company_name": "ADAFRUIT LIMITED",
    "address": "NO 37 GIBSON ROAD UBEJI",
    "date_of_registration": "2015-05-15",
    "type_of_company": "COMPANY"
  }
}
curl -L -X GET '{{baseUrl}}/kyc/cac/advance?class=advance&rc={rc_number}&type={type}' \
-H 'Content-Type: application/json' \
-H 'Authorization: SECRET_KEY'

CAC ADVANCE

Request

{{baseUrl}}/api/v1/kyc/cac/advance

Headers

Parameter

Type

Description

AppId

string

you would need to create an app to get your app ID

Authorization

string

prod_sk_1T1eSavlZxy02OT3OWlvbxK4G

Query Parameters

Parameter Type Description
rc * string RC number required
class * string class value is advance required
type * string type can have the value of co, bn, it required

Response Sample

{
  "entity": {
            "company_name": "A, B and C ESSENTIAL VENTURES",
            "rc_number": "1234567",
            "reg_date": "2015-09-01T18:18:25.007+00:00",
            "address": "NO 78 AKALAT EXP RD, OPP DITTOB, ODO-ONA ELEWE",
            "classification": "BUSINESS NAME",
            "objectives": "",
            "business_nature": "General Merchandise ",
            "business_nature_cat": null,
            "company_type": "BUSINESS_NAME",
            "company_classification": null,
            "state": "OYO",
            "city": "IBADAN",
            "email": "[email protected]",
            "share_capital": "20000000",
            "share_capital_words": "Twenty Million Naira"
        }
}

Did this page help you?