TIN WITH PHONENUMBER

Validate a Tax Identification Number (TIN)

Our TIN Validation endpoint allows businesses to securely and efficiently verify their customers' Tax Identification Numbers (TIN) using phone number. 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/gettinwithphone

📘

GET (TEST)

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

Parameter

Key	Description
number	phone number valid format

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": "N202604130945078064",
    "data": {
        "dateOfBirth": "39/08/0023",
        "firstName": "E*****A",
        "lastName": "A*******E",
        "nin": "13*****74",
        "tax_residency": "Test State",
        "tin": "251*******03"
    },
    "error": {
        "code": null,
        "message": 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
}