Lookup Kenya KRA PIN

Verify a Kenyan KRA PIN (Tax PIN) and confirm it is valid and active with the Kenya Revenue Authority.

Request

[GET]

{{baseUrl}}/api/v1/ke/kyc/kra?pin=A000000010

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
pin *	string	The PIN number	required

Sample response

Response

{
  "entity": {
    "current_status": "Registered",
    "effective_from_date": "23/03/2006",
    "effective_to_date": "",
    "obligation_name": "Income Tax - Resident Individual",
    "pin": "A1234567890",
    "pin_status": "Active",
    "taxpayer_name": "JOHN DOE"
  }
}

Response Fields

Field	Type	Description
entity	object	Contains the verification response data
entity.current_status	string	Current registration status of the KRA PIN
entity.effective_from_date	string	Date the KRA PIN became effective (dd/MM/yyyy)
entity.effective_to_date	string	Date the KRA PIN expires, if applicable
entity.obligation_name	string	Tax obligation type associated with the PIN
entity.pin	string	KRA PIN number
entity.pin_status	string	Active or inactive status of the PIN
entity.taxpayer_name	string	Name of the taxpayer