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!