Company Tax ID - Adhere by Smartcomply

Company/business only. This is a different check from Company TIN — Company Tax ID looks up FIRS tax records using the company’s CAC registration number, while Company TIN looks up FIRS tax records using the company’s TIN. Use whichever identifier you already have.

The Company Tax ID endpoint validates a Nigerian company’s tax records against the FIRS (Federal Inland Revenue Service) database using its CAC registration number, and returns the associated tax identification details.

Endpoint

POST /api/onboarding/business/company_tax_id/

Request

Headers

Header	Value	Required
`x-access-token`	Your API secret key	Yes
`Content-Type`	`application/json`	Yes

Body Parameters

Parameter	Type	Required	Description
`registration_number`	string	Yes	The company’s CAC registration number, including its type prefix (e.g. `RC1234567`, `BN1234567`, `IT1234567`, `LP1234567`, or `LLP1234567`)

Example

curl -X POST "https://adhere-api.smartcomply.com/api/onboarding/business/company_tax_id/" \
  -H "x-access-token: YOUR_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"registration_number": "RC1234567"}'

import requests
response = requests.post(
    "https://adhere-api.smartcomply.com/api/onboarding/business/company_tax_id/",
    headers={"x-access-token": "YOUR_SECRET_KEY", "Content-Type": "application/json"},
    json={"registration_number": "RC1234567"},
)

Response

200 OK

Field	Type	Description
`data.valid`	boolean	Whether a match was found
`data.business_name`	string	Registered company name
`data.registration_number`	string	CAC registration number
`data.id_number`	string	Company’s Tax ID
`data.company_information.name`	string	Registered company name
`data.company_information.registration_number`	string	CAC registration number
`data.company_information.tax_id`	string	Company’s Tax ID
`data.company_information.tax_office`	string	Assigned tax office (not returned by Youverify for every company)
`data.company_information.phone`	string	Registered phone number (not returned by Youverify for every company)
`data.company_information.email`	string	Registered email (not returned by Youverify for every company)

{
  "status": "success",
  "data": {
    "valid": true,
    "id_number": "2622476055669",
    "company_information": {
      "name": "OASIS TASTE & TREAT LTD",
      "registration_number": "RC9435541",
      "tin": null,
      "jtb_tin": null,
      "tax_id": "2622476055669",
      "tax_office": null,
      "phone": null,
      "email": null
    },
    "business_name": "OASIS TASTE & TREAT LTD",
    "registration_number": "RC9435541"
  },
  "message": "Company Tax ID details retrieved successfully"
}

400 Bad Request

{
  "status": "failed",
  "data": [],
  "message": "Registration Number is required."
}

{
  "status": "failed",
  "data": {"error_code": "INVALID_INPUT"},
  "message": "Company Tax ID check failed: ValidationError: Invalid registration number format. Valid format => RCxxxx, BNxxxxx, ITxxxxx, LPxxxxx or LLPxxxxx"
}

401 Unauthorized

{
  "status": "failed",
  "message": "Authentication credentials were not provided."
}