Skip to main content
POST
Tax Identification Number (TIN)
Company/business TIN only. Individual TIN lookups are not supported by any provider behind this endpoint.
The Company TIN endpoint validates a business Tax Identification Number against the FIRS (Federal Inland Revenue Service) database and returns the associated taxpayer name, CAC registration number, tax office, and contact details.
/api/onboarding/business/company_tin/ is an alias for this same endpoint and check. If you’re already integrated against it, no change is needed — it continues to work. For new integrations, use /api/onboarding/nigeria_kyc/tin/ above.

Endpoint

Request

Headers

Body Parameters

Example

Response

200 OK

400 Bad Request

401 Unauthorized

Authorizations

x-access-token
string
header
required

Your Adhere API secret key

Body

application/json
tax_identification_number
string
required

The company's Tax Identification Number (format: 234123456-0001, 8-14 digits)

Example:

"234123456-0001"

Response

TIN verified