Nigeria KYB TIN Verification API
Overview and Purpose
Overview:
The Nigeria KYB – TIN Verification API enables businesses to verify a company's Tax Identification Number (TIN) in Nigeria in real time.
By integrating Dojah’s Nigeria KYB TIN API, organizations can seamlessly validate registered businesses and retrieve authoritative company tax records directly from official data sources.
API Details
Sample cURL
curl --location 'https://api.signzy.app/api/v3/global/ng-tin-verification' \
--header 'Authorization: <AUTH_KEY>' \
--header 'Content-Type: application/json' \
--data '{"tin":"12345678-1234"}'Request Body
{
"tin": "12345678-1234"
}Request Body Parameters
Field | Type | Description |
|---|---|---|
tin | string | Tax Identification Number (TIN) used to uniquely identify a taxpayer or business entity. |
Response Body (Nigeria KYB TIN Verification)
{
"code": "S001",
"reason": "Request Successful",
"result": {
"entity": {
"address": "<address>",
"cacRegistrationNumber": "<cac_registration_number>",
"email": "<email_address>",
"firstin": "<firstin>",
"jtbtin": "<jtb_tin>",
"phone": "<phone_number>",
"search": "<search_value>",
"taxOffice": "<tax_office>",
"taxpayerName": "<taxpayer_name>"
}
}
}Response Body Parameters (Nigeria KYB TIN Verification)
Parameter | Description | Data Type |
|---|---|---|
code | Response status code indicating the outcome of the request. | string |
reason | Message describing the request result. | string |
result | Object containing taxpayer lookup details. | object |
result.entity | Object containing taxpayer information. | object |
result.entity.search | Search reference or identifier used for the query. | string |
result.entity.taxpayerName | Name of the registered taxpayer or organization. | string |
result.entity.cacRegistrationNumber | Corporate Affairs Commission (CAC) registration number. | string |
result.entity.firstin | Primary Tax Identification Number associated with the taxpayer. | string |
result.entity.jtbtin | Joint Tax Board Tax Identification Number. | string |
result.entity.taxOffice | Assigned tax office managing the taxpayer account. | string |
result.entity.phone | Registered contact phone number. | string |
result.entity.email | Registered email address of the taxpayer. | string |
result.entity.address | Official registered address of the taxpayer. | string |
Error Code Response & Mapping
{
"result": {},
"reason": "Upstream error",
"code": "E401"
}
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!