Skip to main content

​
Request

[GET]
{{baseUrl}}/api/v1/kyc/tin
HeaderTypeDescription
AppIdstringCreate an app to get your app ID on dashboard here
AuthorizationstringPrivate/secret key. Use <key> not Bearer <key>

​
Query parameter

ParameterTypeDescriptionRequired
tin *stringA valid TINrequired

​
Sample response

Response
{
  "entity": {
    "search": "18609323-0001",
    "taxpayer_name": "BRYAN GODWIN NIG LTD",
    "cac_reg_number": "3897612",
    "firstin": "18609323-0001",
    "jittin": "N/A",
    "tax_office": "MSTO ALIMOSHO",
    "phone_number": "08012345678",
    "email": "test@gmail.com"
  }
}

​
Response Fields

FieldTypeDescription
entityobjectContains the FIRS TIN validation response data
entity.searchstringThe TIN value that was searched
entity.taxpayer_namestringRegistered name of the taxpayer
entity.cac_reg_numberstringCAC registration number associated with the taxpayer
entity.firstinstringFederal Inland Revenue Service TIN
entity.jittinstringJoint Tax Board TIN (N/A if not available)
entity.tax_officestringAssigned FIRS tax office for the taxpayer
entity.phone_numberstringPhone number on file for the taxpayer
entity.emailstringEmail address on file for the taxpayer

​
Test Credentials for Sandbox

Kindly use this test TIN in the sandbox environment. TIN = 18609323-0001