Verify TIN

base_url: https://firseinvoice.etranzactng.com/

Description: This allows taxpayers/users to verify registered details of a Tax Identification Number (TIN)

Sample Request

Request Parameters

Parameter	Type	Description	Required?
irn	string	Tax Identification Number (TIN) is a unique number issued by FIRS (or JTB/SBIR) for filing tax returns and other tax-related transactions.	Yes

Sample Response

Response Parameters

Parameter	Type	Description	Required?
status	integer	HTTP status code	Yes
message	string	Description of http status code	Yes
data	object	A nested data object containing the primary details of the response.	Yes
id	string	Unique identifier of the request	Yes
tin	string	Tax Identification Number (TIN)	Yes
taxpayer_name	string	Tax payer name	Yes
address	string	Tax payer address	Yes
taxofficer_id	string	Tax officer unique identifier	Yes
taxofficer_name	string	Tax officer name	Yes
rc_number	string	RC number is the unique identification number for a Limited Liability Company (LLC) registered with the Corporate Affairs Commission (CAC) in Nigeria	Yes
email	string	Email address	Yes
phone	string	Phone number	Yes
execTime	integer	Time taken to process request (for metrics and performance tracking)	Yes
error	integer	Specific errors when request does not return a HTTP status of 200	No

Sample Request

Request Parameters

POST {base_url}/api/v1/utilities/verify-tin/

curl `{base_url}/api/v1/utilities/verify-tin/`
  -H "X-API-Key: {{CLIENT_API_KEY}}"
  -H "X-API-Signature: {{HMAC_SHA256_SIGNATURE}}"
  -H "X-API-Timestamp: {{ISO_20022_TIMESTAMP}}"
  -H "Content-Type: application/json"
  -d '{
    "tin": "87654321-0231"
   }
'

Sample Response

Sample Success Response

POST {base_url}/api/v1/utilities/verify-tin/

{
    "status": 200,
    "message": "TIN Information",
    "data": {
        "id": "fbcf09b3-4652-4040-b1d2-c2458bdf5703",
        "status": "200 OK",
        "tin": "32222222-0001",
        "taxpayer_name": "MARVEL FARMS PRODUCE BIZ",
        "address": "K12, IFEWUMI STR, EGBEDA, IBADAN, OYO STATE",
        "taxofficer_id": "22",
        "taxofficer_name": "MSTO IWO ROAD",
        "rc_number": "7944849",
        "email": "iyanuoluwaajibada@gmail.com",
        "phone": "09091601918"
    },
   "execTime": 1.234568,
   "error": ""
}