TIN

Validate a Tax Identification Number (TIN)

Our TIN Validation endpoint allows businesses to securely and efficiently verify their customers' Tax Identification Numbers (TIN). This service ensures the integrity and accuracy of tax-related data, facilitating smoother compliance with local tax regulations.

Key Features:

• Instant Verification: Confirm the validity of the TIN quickly.

📘

GET (LIVE)

{{URL}}/dikript/verification/api/v1/gettin

📘

GET (TEST)

{{URL}}/dikript/test/api/v1/gettin

Parameter

Key	Description
tin	tin number valid format (XXXXXXXX-XXXX)

Header (LIVE)

Key	Description
x-api-key	Your Secret Key

Header (TEST)

Key	Description
x-api-key	Your Public Key

Responses

jsc

{
    "status": true,
    "message": "Successful",
    "code": "200",
    "apiVersion": "v1",
    "transactionRef": "N202410230353573933",
    "data": {
        "tin": "244***52-0**1",
        "taxpayerName": "TEST IT SOLUTIONS",
        "cacRegNo": "3****42",
        "jittin": "",
        "taxOffice": " ISOLO",
        "phone": "0803****682",
        "email": "ch****[e-mail]",
        "entityType": ""
    },
    "error": null
}

JSON

{
    "message": "Unsuccessful",
    "code": "400",
    "apiVersion": "v1",
    "transactionRef": "N202401101345487388",
    "data": "",
    "error": {
        "code": 400,
        "message": null
    }
}

js

{
    "status": true,
    "message": "nin not found",
    "code": "200",
    "apiVersion": "v1",
    "transactionRef": "N202401101323024787",
    "data": {
        "firstName": "",
        "birthDate": "",
        "employmentStatus": "",
        "gender": "",
        "middleName": "",
        "nin": "",
        "vNin": "",
        "email": "",
        "otherName": "",
        "profession": "",
        "birthCountry": "",
        "otherSpokenLang": "",
        "nokFirstName": "",
        "nokLastName": "",
        "nokMiddleName": "",
        "photo": "",
        "residenceAdressLine1": "",
        "residenceAdressLine2": "",
        "residenceLga": "",
        "residenceState": "",
        "selfOriginState": "",
        "selfOriginLga": "",
        "selfOriginPlace": "",
        "signature": "",
        "surname": "",
        "telephoneNo": "",
        "title": "",
        "trackingId": ""
    },
    "error": null
}