GET
Verify a Ghanaian Tax Identification Number (TIN) with the revenue authority.
/api/v1/gh/kyb/tinHeaders
| Header | Required | Description |
|---|---|---|
Authorization | Yes | Your app’s secret key, sent as-is — not Bearer. |
AppId | Yes | The App ID from your dashboard. |
Query parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
tin | string | Yes | The TIN number. |
Response
Returns anentity object with the record for the supplied identifier.
Errors
| Code | Meaning |
|---|---|
400 | Bad request — a required parameter is missing or malformed. |
401 | Unauthorized — check your key and AppId (no Bearer prefix). |
402 | Insufficient wallet balance. Fund your wallet. |
404 | No record found for the supplied identifier. |
424 | The upstream source was unavailable — retry shortly. |
429 | Too many requests — back off and retry. |
curl --request GET \
"https://api.dojah.io/api/v1/gh/kyb/tin?tin=C1234556787" \
-H "Authorization: {{secret_key}}" \
-H "AppId: {{app_id}}"
const params = new URLSearchParams({
"tin": "C1234556787",
});
const url = "https://api.dojah.io/api/v1/gh/kyb/tin?" + params;
const res = await fetch(url, {
headers: {
Authorization: process.env.DOJAH_SECRET_KEY,
AppId: process.env.DOJAH_APP_ID,
},
});
const data = await res.json();
import os, requests
res = requests.get(
"https://api.dojah.io/api/v1/gh/kyb/tin",
headers={
"Authorization": os.environ["DOJAH_SECRET_KEY"],
"AppId": os.environ["DOJAH_APP_ID"],
},
params={ "tin": "C1234556787" },
)
data = res.json()
{
"entity": {
"tin": "C1234556787",
"taxpayer_name": "JOHN DOE",
"trading_as": "123R43A",
"rgdno": "12345678",
"tax_office": "ACCRA",
"regn_status": "REGISTERED",
"is_valid": true
}
}