Tax Identification Number (TIN)

This endpoint allows you to verify a tax identification number.

This endpoint provides a powerful solution for businesses and organizations to automate the TIN verification process for other companies. With this, you can quickly and easily verify the TINs of other businesses if you’re looking to onboard them as business partners or clients, ensuring that your records are accurate and up-to-date.

Our TIN verification endpoint utilizes the latest technology and data sources to provide reliable TIN verification results, giving you peace of mind that your compliance requirements are being met. All you need to utilize this endpoint is to make provisions of a business’ accurate TIN.

👍

TEST DATA

number: Rc323479

channel: CAC

20304753-0001

📘

POST

{{URL}}/identitypass/verification/tin

Request Header

KeyDescription
app-idYour App ID
x-api-keyYour Secret Key

Request Body

KeyDescription
numberTIN or RC number or Phone number
channelTIN,CAC or Phone - (Default: TIN)

Sample Response

{
    "status": true,
    "detail": "TIN Verification Successful",
    "response_code": "00",
    "data": {
        "taxpayer_name": "test test",
        "cac_reg_number": "Rc323479",
        "firstin": "12392112349",
        "jittin": "10001",
        "tax_office": "yaba tax office",
        "phone_number": "08082838487",
        "email": "[email protected]"
    }
}

Response Description

ResponseDescription
statusIndicates that the request was successful.
detailThis field indicates the detail of the response.
response_codeRepresents the response code.
dataAn array containing the information received.
taxpayer_nameThe name of the taxpayer associated with the entity.
cac_reg_numberThe registration number assigned to the entity by the CAC.
firstinThe date when the entity was first registered or incorporated.
jittinThe date when the entity was last updated or modified in the database
tax_office. The tax office or jurisdiction to which the entity is registered for tax purposes.
phone_numberThe contact phone number associated with the entity.
emailThe contact email address associated with the entity.