TIN Validation
Check whether a tax identification number exists, without retrieving the taxpayer record. Takes the bare-digit NRS form (10-13 digits), which is a different form from the one /tin/verify takes. **A 200 means the check ran, not that the number exists — read `result`, which is VALID or INVALID.** A negative answer is a real answer and is charged for. Billed separately from TIN Verification; a subscription to one does not grant the other.
/v1/tin/validateAuthorization
api-key In: header
Header Parameters
Required for live-mode keys. Unique key identifying this request attempt.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/v1/tin/validate" \ -H "Content-Type: application/json" \ -d '{ "tin": "1001180000" }'{ "success": true, "statusCode": 200, "message": "Request processed successfully", "timestamp": "2025-10-20T16:30:00.000Z", "path": "/v1/auth/register", "data": { "verificationStatus": "VERIFIED", "referenceId": "VER-TIN_NG-JPGI3POERX", "verificationId": "9f2c1a7b4e6d8f30", "charged": true, "chargeAmount": 50, "result": "VALID", "format": "1001180000", "tinType": "NRS - Tax Identification Number (Tax ID)", "country": "Nigeria (NG)" }}TIN Verification by phone number
Retrieve the taxpayer record registered against a Nigerian phone number. Billed as part of TIN Verification — the same subscription covers this and /tin/verify.
TIN from NIN
Retrieve a person's tax identification number from their National Identification Number, together with the identity fields that let you confirm it belongs to the person you meant. Billed separately from TIN Verification and TIN Validation. Note that unlike /tin/verify, a lookup that finds no record is still charged.