CAC Verification

This endpoint is used to verify the Corporate Affairs Commission (CAC) information of a company. It requires the company registration number and type, with a company name.

Endpoint: POST {baseurl}/v1/api/verification/cac

Request Body

Field Name	Type	Required	Description
country	string	Yes	The country code for the verification. Example: NGA.
reference	string	Yes	A unique reference for the verification request. Example: 0122333444455555.
identity	string	Yes	A unique identifier for the entity being verified. Example: 6791457be570f7f292f1fe23.
verificationLevel	string	Yes	The level of verification to perform. Example: basic.
rcNumber	string	Yes	The company registration number to verify. Example: 12345678.
companyType	string	Yes	The type of company to verify. Example: RC. Default: RC.
companyName	string	Yes	The name of the company to verify. Example: Example Company Ltd.

Notes - All string fields are trimmed of leading and trailing whitespace before processing.

Example Request Body

{
    "country": "NGA",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "rcNumber": "12345678",
    "companyType": "RC",
    "companyName": "Example Company Ltd"
}

Sample Request

curl

curl -X POST "{baseurl}/v1/api/verification/cac" \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
        "rcNumber": "12345678",
        "companyType": "RC",
        "companyName": "Example Company Ltd"
    }'

Sample Response

BasicPremium

{
    "status": true,
    "responseCode": "00",
    "statusCode": 200,
    "message": "CAC verification successful",
    "data": {
        "rcNumber": "12345678",
        "companyType": "RC",
        "companyName": "Example Company Ltd",
        "isValid": true
    },
    "meta": {
        "statusCode": 200,
        "referenceId": "abc123",
        "timeStamp": "2023-10-01T12:00:00Z"
    }
}

{
  "status": true,
  "responseCode": "00",
  "statusCode": "200",
  "message": "CAC verification successful",
  "data": {
    "rcNumber": "",
    "documentNumber": "",
    "documentName": "",
    "documentExpiryDate": null,
    "documentIssuingCountry": "",
    "companyName": "",
    "companyStatus": "",
    "registrationDate": "",
    "directors": [
      {
        "surname": " ",
        "firstName": " ",
        "otherName": " ",
        "email": "",
        "phoneNumber": "",
        "city": "",
        "state": "",
        "dateOfAppointment": "",
        "status": "",
        "affiliateTypeFk": {
          "name": "",
          "description": ""
        },
        "countryFk": {
          "name": "",
          "code": ""
        },
        "lga": "",
        "address": " ",
        "postcode": null
      },
      {
        "surname": " ",
        "firstName": " ",
        "otherName": " ",
        "email": "",
        "phoneNumber": "",
        "gender": "",
        "formerNationality": null,
        "city": "",
        "occupation": "",
        "formerName": null,
        "corporationName": null,
        "rcNumber": null,
        "state": "",
        "accreditationNumber": null,
        "formType": " ",
        "numSharesAlloted": "",
        "typeOfShares": "",
        "dateOfBirth": "",
        "dateOfAppointment": "",
        "status": "",
        "formerSurname": null,
        "formerFirstName": null,
        "formerOtherName": null,
        "identityNumber": "",
        "otherDirectorshipDetails": null,
        "affiliateTypeFk": {
          "name": "",
          "description": ""
        },
        "countryFk": {
          "name": "",
          "code": ""
        },
        "lga": "",
        "nationality": "",
        "address": " ",
        "streetNumber": " ",
        "postcode": null,
        "formerNameType": null,
        "affiliatesResidentialAddress": {
          "country": "",
          "state": "",
          "lga": "",
          "city": "",
          "address": " ",
          "streetNumber": ""
        },
        "affiliatesPscInformation": ""
      },
      {
        "surname": " ",
        "firstName": "",
        "otherName": null,
        "email": "",
        "phoneNumber": "",
        "gender": null,
        "formerNationality": null,
        "city": " ",
        "occupation": "",
        "formerName": null,
        "corporationName": null,
        "rcNumber": null,
        "state": "",
        "accreditationNumber": null,
        "formType": null,
        "typeOfShares": null,
        "dateOfAppointment": "",
        "status": "",
        "formerSurname": null,
        "formerFirstName": null,
        "formerOtherName": null,
        "identityNumber": null,
        "otherDirectorshipDetails": null,
        "affiliateTypeFk": {
          "name": "",
          "description": ""
        },
        "countryFk": {
          "name": "",
          "code": ""
        },
        "lga": "",
        "isCorporate": null,
        "address": " ",
        "streetNumber": "",
        "isChairman": "",
        "postcode": null,
        "formerNameType": null
      },
      {
        "surname": " ",
        "firstName": " ",
        "otherName": " ",
        "email": "",
        "phoneNumber": "",
        "gender": "",
        "formerNationality": null,
        "city": "",
        "occupation": " ",
        "formerName": null,
        "corporationName": null,
        "rcNumber": null,
        "state": "",
        "accreditationNumber": null,
        "formType": "",
        "numSharesAlloted": "",
        "typeOfShares": "",
        "dateOfBirth": "",
        "dateOfAppointment": "",
        "status": "",
        "formerSurname": null,
        "formerFirstName": null,
        "formerOtherName": null,
        "identityNumber": "",
        "otherDirectorshipDetails": null,
        "affiliateTypeFk": {
          "name": "",
          "description": ""
        },
        "countryFk": {
          "name": "",
          "code": ""
        },
        "lga": "",
        "nationality": "",
        "address": " ",
        "streetNumber": "",
        "postcode": null,
        "formerNameType": null,
        "affiliatesResidentialAddress": {
          "country": "",
          "state": "",
          "lga": "",
          "city": " ",
          "address": " ",
          "streetNumber": ""
        },
        "affiliatesPscInformation": ""
      },
     // so on for other directors
    ]
  },
  "meta": {
    "statusCode": "200",
    "isValid": true,
    "timeStamp": "Wed Apr 23 2025 07:29:57 GMT+0000 (Coordinated Universal Time)"
  }
}