Tax Identification Number

Tax Identification Number (TIN) verification

Please note that when using your test key, Our test company persona is John Doe and the corporate Tax Identification Number is 00000000-0000.

Verify TIN

GET https://vapi.verifyme.ng/v1/verifications/identities/tin/:ref

Headers

Name	Type	Description
Authorization	string	Authorization Header - Bearer Token

200

{
    "status": "success",
    "data": {
        "tin": "00000000-0000",
        "taxpayerName": "John Doe",
        "cacRegNo": "RC18*****",
        "entityType": "00000000-0000",
        "jittin": "",
        "taxOffice": "Tax Office Address",
        "phone": "090********",
        "email": "[e-mail]"
    }
}

400 Invalid TIN format

{
    "statusCode": 400,
    "error": "Bad Request",
    "message": "Invalid TIN Format. Valid Tin format => XXXXXXXX-XXXX"
}

404 TIN not found

{
    "statusCode": 404,
    "error": "Not Found",
    "message": "Company with provided TIN details not found"
}