TIN

Validate a tax identification number

Our endpoint allows businesses to easily and securely verify their customers' national ID number as well as their tax ID number, protecting the confidentiality of their sensitive information.

This endpoint uses innovative technology to instantly authenticate your clients' identities, giving you access to a variety of exclusive advantages and services. With only a few clicks, you can authenticate your clients' identities and ensure a flawless experience.

📘

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****[email protected]",
        "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
}