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.

get
Verify TIN

https://vapi.verifyme.ng/v1/verifications/identities/tin/:ref
Request
Response
Request
Headers
Authorization
required
string
Authorization Header - Bearer Token
Response
200: OK
{
"status": "success",
"data": {
"tin": "00000000-0000",
"taxpayerName": "John Doe",
"cacRegNo": "RC18*****",
"entityType": "00000000-0000",
"jittin": "",
"taxOffice": "Tax Office Address",
"phone": "090********",
"email": "[email protected]"
}
}
400: Bad Request
Invalid TIN format
{
"statusCode": 400,
"error": "Bad Request",
"message": "Invalid TIN Format. Valid Tin format => XXXXXXXX-XXXX"
}
404: Not Found
TIN not found
{
"statusCode": 404,
"error": "Not Found",
"message": "Company with provided TIN details not found"
}