API ReferenceTIN Verification
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.
POST
/v1/tin/from-ninAuthorization
api-key x-api-key<token>
In: header
Header Parameters
X-Correlation-ID?string
Idempotency-Key?string
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/from-nin" \ -H "Content-Type: application/json" \ -d '{ "nin": "12345678901" }'{ "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, "tin": "1234567890123", "firstName": "Ada", "lastName": "Okoro", "dateOfBirth": "01/01/1990", "nin": "12345678901", "taxResidency": "Lagos State" }}Empty
Empty
Empty
Empty
Empty
Empty