Verify TIN

Verify Individual and Corporate Tax Identification Numbers (TIN) in real-time against the Joint Tax Board (JTB) database. Essential for KYC, onboarding, and tax compliance workflows.

HTTP Request

GEThttps://pioe.app/api/v1/verify/tin

Query Parameters

Parameter	Type	Required	Description
tin	string	Yes	The tax number to verify.
type	string	No	Optional context value: "individual" or "corporate".

Code Examples

const tin = "12345678";
const type = "individual";
const response = await fetch(`https://pioe.app/api/v1/verify/tin?tin=${tin}&type=${type}`, {
  headers: {
    "X-API-Key": "your_api_key"
  }
});

const data = await response.json();
console.log(data)

Example Response

200 OK

{
  "isValid": true,
  "tin": "12345678",
  "type": "individual",
  "data": {
    "tin": "12345678",
    "type": "individual",
    "name": "JOSHUA DOE",
    "taxOffice": "Lagos Island MSEO"
  },
  "message": "Verification successful"
}

Python Snippet

import requests

url = "https://pioe.app/api/v1/verify/tin"
params = { "tin": "12345678", "type": "individual" }
headers = { "X-API-Key": "your_api_key" }

response = requests.get(url, params=params, headers=headers)
print(response.json())

Live Database Access

This API provides a direct proxy to the Joint Tax Board federation servers.

Try it Live

Use our interactive playground to test requests in real-time.

Open Playground