CAC verification endpoints let you confirm the registration details of Nigerian businesses. Additional endpoints on this page cover TIN, driver’s license, and passport verification. Each call consumes your KYC balance or quota.
Authentication
x-api-key: your_api_key
x-api-secret: your_api_secret
Zeeh — Basic CAC lookup
Return basic registration details for a company by RC number.
POST /api/v1/kyc/zee/cac/basic
Request body
The CAC Registration Number (RC Number) of the company.
The registered company name. Used to validate the lookup.
The type of company registration. Example values: "RC" (private limited), "BN" (business name), "IT" (incorporated trustee).
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/zee/cac/basic \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{
"rcNumber": "1234567",
"companyName": "Acme Nigeria Limited",
"companyType": "RC"
}'
Example response
{
"success": true,
"data": {
"rcNumber": "1234567",
"companyName": "ACME NIGERIA LIMITED",
"companyType": "Private Limited Company",
"registrationDate": "2015-03-12",
"address": "1 Business District, Lagos",
"status": "Active"
}
}
Zeeh — Advanced CAC lookup
Returns extended company details including directors and shareholders.
POST /api/v1/kyc/zee/cac/advanced
Request body
The registered company name.
Company registration type (e.g. "RC", "BN", "IT").
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/zee/cac/advanced \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{
"rcNumber": "1234567",
"companyName": "Acme Nigeria Limited",
"companyType": "RC"
}'
Example response
{
"success": true,
"data": {
"rcNumber": "1234567",
"companyName": "ACME NIGERIA LIMITED",
"status": "Active",
"directors": [
{ "name": "John Smith", "nationality": "Nigerian" }
],
"shareholders": [
{ "name": "Jane Doe", "shares": 50000 }
]
}
}
Interswitch — CAC lookup by company name
Search the CAC database for a company by name.
POST /api/v1/kyc/switch/cac
Request body
Company name to search for in the CAC database.
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/switch/cac \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{ "companyName": "Acme Nigeria" }'
Example response
{
"success": true,
"data": {
"results": [
{
"rcNumber": "1234567",
"companyName": "ACME NIGERIA LIMITED",
"status": "Active"
}
]
}
}
Interswitch — CAC shareholders
Retrieve the list of shareholders for a company by RC number.
POST /api/v1/kyc/switch/cac/shareholders
Request body
The CAC RC Number of the company.
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/switch/cac/shareholders \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{ "rcNumber": "1234567" }'
Example response
{
"success": true,
"data": {
"rcNumber": "1234567",
"shareholders": [
{ "name": "Jane Doe", "shares": 50000, "nationality": "Nigerian" }
]
}
}
Interswitch — CAC secretary
Retrieve the company secretary details for a company.
POST /api/v1/kyc/switch/cac/secretary
Request body
The CAC RC Number of the company.
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/switch/cac/secretary \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{ "rcNumber": "1234567" }'
Example response
{
"success": true,
"data": {
"rcNumber": "1234567",
"secretary": {
"name": "Michael Brown",
"address": "5 Law Chambers, Lagos"
}
}
}
Interswitch — CAC director
Retrieve the directors for a company.
POST /api/v1/kyc/switch/cac/director
Request body
The CAC RC Number of the company.
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/switch/cac/director \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{ "rcNumber": "1234567" }'
Example response
{
"success": true,
"data": {
"rcNumber": "1234567",
"directors": [
{
"name": "John Smith",
"nationality": "Nigerian",
"dateOfAppointment": "2015-03-12"
}
]
}
}
Interswitch — TIN verification
Verify a Tax Identification Number (TIN) issued by FIRS.
POST /api/v1/kyc/switch/tin
Request body
The Tax Identification Number to verify.
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/switch/tin \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{ "tin": "12345678-0001" }'
Example response
{
"success": true,
"data": {
"tin": "12345678-0001",
"taxpayerName": "ACME NIGERIA LIMITED",
"taxOffice": "Lagos Island",
"status": "Active"
}
}
Interswitch — Driver’s license verification
Verify a Nigerian driver’s license number.
POST /api/v1/kyc/switch/drivers-license
Request body
The driver’s license number to verify.
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/switch/drivers-license \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{ "licenseNumber": "AAB00000AA00" }'
Example response
{
"success": true,
"data": {
"licenseNumber": "AAB00000AA00",
"firstName": "Jane",
"lastName": "Doe",
"dateOfBirth": "1990-01-15",
"issueDate": "2020-03-01",
"expiryDate": "2025-03-01",
"stateOfIssue": "Lagos"
}
}
Interswitch — International passport verification
Verify a Nigerian international passport.
POST /api/v1/kyc/switch/passport
Request body
The passport number to verify.
The passport holder’s last name.
The passport holder’s date of birth in YYYY-MM-DD format.
Example request
curl --request POST \
--url https://api.hyparrow.com/api/v1/kyc/switch/passport \
--header 'Content-Type: application/json' \
--header 'x-api-key: your_api_key' \
--header 'x-api-secret: your_api_secret' \
--data '{
"passportNumber": "A12345678",
"lastName": "Doe",
"dob": "1990-01-15"
}'
Example response
{
"success": true,
"data": {
"passportNumber": "A12345678",
"firstName": "Jane",
"lastName": "Doe",
"dateOfBirth": "1990-01-15",
"issueDate": "2019-06-01",
"expiryDate": "2029-06-01",
"nationality": "Nigerian"
}
}
