CAC Company

Gets the detailed information of a specific company registered with the CAC of Nigeria by its ID.

Endpoint

GET /kyc/nga/cac/company/{id}

Authentication

Type	Location	Name
API Key	Header	x-api-key

Path parameters

Parameter	Type	Required	Description
id	string	Yes	Company ID obtained from the search.

Request example

GET /kyc/nga/cac/company/company-id-123

Responses

200 Success

Response parameters

Parameter	Type	Description
serviceResultCode	integer	Code indicating the overall result of the service execution. See Service Result Code
serviceTime	string	Processing time (milliseconds).
serviceResultLog	string	Descriptive field of the service execution result. Includes details when there is an error or exception in the module.
serviceTransactionId	string	Transaction identifier associated with the request processed by the API.
data	object	Object with the company's complete data. See the table below.

Response parameters — data

Parameter	Type	Description
id	string	Unique company identifier.
rcNumber	string	Registration number (RC Number).
companyName	string	Registered company name.
companyType	string	Company type.
status	string	Current status of the company. Possible values: ACTIVE, INACTIVE, DISSOLVED
registrationDate	string	Registration date.
address	string	Registered address.
city	string	City.
state	string	Status.
email	string	Email address.
phoneNumber	string	Phone number.
authorizedShareCapital	string	Authorized share capital.
paidUpShareCapital	string	Paid-up share capital.
businessActivity	string	Main business activity.
numberOfDirectors	integer	Number of directors.
numberOfShareholders	integer	Number of shareholders.

Service Result Code

The serviceResultCode indicates the overall result of the service execution:

serviceResultCode	Description	HTTP Code
200	The service execution was successful, the module processed the request correctly.	200

Response example

{
  "serviceResultCode": 200,
  "serviceTime": "1500",
  "serviceResultLog": "Success",
  "serviceTransactionId": "c29f013g-12g0-9f1j-f64f-0g469fh00hi",
  "data": {
    "id": "company-id-123",
    "rcNumber": "RC123456",
    "companyName": "ACME NIGERIA LIMITED",
    "companyType": "LIMITED LIABILITY COMPANY",
    "status": "ACTIVE",
    "registrationDate": "2020-05-15",
    "address": "123 Business Street, Victoria Island, Lagos",
    "city": "Lagos",
    "state": "Lagos State",
    "email": "[email protected]",
    "phoneNumber": "[phone]",
    "authorizedShareCapital": "10000000",
    "paidUpShareCapital": "5000000",
    "businessActivity": "Information Technology Services",
    "numberOfDirectors": 3,
    "numberOfShareholders": 2
  }
}

400 Bad Request

Error returned with the service envelope (serviceResultCode reflects the HTTP status code of the response):

{
  "serviceResultCode": 400,
  "serviceResultLog": "Sorry, lookup failed. Please check the details and try again",
  "serviceTime": "151",
  "serviceTransactionId": "08ac9699-dc9e-4cdc-81d7-264f71838309"
}

502 Bad Gateway

Returned when the service is temporarily unavailable or its response could not be interpreted. The body uses the service envelope with serviceResultCode: 500:

{
  "serviceResultCode": 500,
  "serviceResultLog": "Service temporarily unavailable. Please try again later",
  "serviceTime": "3000",
  "serviceTransactionId": "38de2932-0f2h-7gff-14g0-597h04161632"
}

504 Gateway Timeout

Timeout error Timeout, returned with the service envelope:

{
  "serviceResultCode": 504,
  "serviceResultLog": "Request timeout. Please try again",
  "serviceTime": "30000",
  "serviceTransactionId": "48ef3043-1g3i-8hgg-25h1-608i15272743"
}

Authentication errors (401/403) are rejected by the gateway before reaching the service and do not use the envelope serviceResultCode. Platform validation errors use the format application/problem+json. See Error handling for details on the three response formats.