Search
K
Links

Tax Identification Number (TIN) Verification

post
{{baseurl}}
/v2/api/verifications/ng/tin
TIN Verification
Parameters
Header
token*
String
API Secret token
Body
tin*
String
Valid TIN
isSubjectConsent*
Boolean
Indicate you have consent. Must be true
Responses
TIN Verification
{
"tin": "00000000-0000",
"isConsent": true
}
Found Response
Not Found Response
{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"id": "626636002c1fbe4da972a50d",
"status": "not_found",
"businessId": "61d880f1e8e15aaf24558f1a",
"parentId": null,
"isConsent": true,
"type": "tin-lookup",
"name": null,
"registrationNumber": null,
"tin": "20504133-0002",
"jtbTin": null,
"taxOffice": null,
"email": null,
"phone": null,
"requestedAt": "2022-04-25T05:47:46.398Z",
"createdAt": "2022-04-25T05:47:46.782Z",
"requestedBy": {
"firstName": "API",
"lastName": "User",
"middleName": "",
"id": "61d880f2e8e15aaf24558f9b"
}
},
"links": []
}
{
"success": true,
"statusCode": 200,
"message": "success",
"data": {
"id": "626636002c1fbe4da972a50d",
"status": "not_found",
"businessId": "61d880f1e8e15aaf24558f1a",
"parentId": null,
"isConsent": true,
"type": "tin-lookup",
"name": null,
"registrationNumber": null,
"tin": "20504133-0002",
"jtbTin": null,
"taxOffice": null,
"email": null,
"phone": null,
"requestedAt": "2022-04-25T05:47:46.398Z",
"createdAt": "2022-04-25T05:47:46.782Z",
"requestedBy": {
"firstName": "API",
"lastName": "User",
"middleName": "",
"id": "61d880f2e8e15aaf24558f9b"
}
},
"links": []
}
Error Response
{
"success": false,
"statusCode": 404,
"message": "You have attempted to get a resource that does not exist.",
"name": "ResourceNotFoundError",
"data": {}
}