Lookup Ghana TIN

Verify a Ghanaian individual Tax Identification Number (TIN) with the revenue authority. For business TIN use Ghana Business Lookup.

Request

[GET]

{{baseUrl}}/api/v1/gh/kyb/tin?tin=C00000000021

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameter

Parameter	Type	Description	Required
tin *	string	The TIN number	required

Sample response

Response

{
  "entity": {
    "is_valid": true,
    "regn_status": "REGISTERED",
    "rgdno": "12345678",
    "tax_office": "ACCRA",
    "taxpayer_name": "JOHN DOE",
    "tin": "C1234556787",
    "trading_as": "123R43A"
  }
}

Response Fields

Field	Type	Description
entity	object	Contains the verification response data
entity.is_valid	boolean	Whether the TIN is valid
entity.regn_status	string	Registration status of the taxpayer
entity.rgdno	string	Registered number associated with the TIN
entity.tax_office	string	Tax office where the taxpayer is registered
entity.taxpayer_name	string	Name of the taxpayer
entity.tin	string	Tax Identification Number
entity.trading_as	string	Trading name or alias of the taxpayer