Tax PIN Verification

Kenyan Tax PIN Verification API

To perform verification on a Kenyan Tax PIN, make a POST request to the following endpoint;

https://api.korapay.com/merchant/api/v1/identities/ke/tax-pin

The request body should have the following parameters:

{
   "id": "A009234567J",
   "verification_consent": true
}

The fields in this request include:

Field	Data Type	Description
`id`	String	Required - the ID number
`verification_consent`	Boolean	Required - this indicates that subject has given consent to perform this verification. This must be `true` for the check to be performed.

The response to this request would look like this:

{
   "status": true,
   "message": "Tax pin verified successfully",
   "data": {
       "reference": "VR-B2kGDcf2kLPEzzlUG",
       "id": "A009274635J",
       "id_type": "ke_tax_pin",
       "pin": "A009274635J",
       "pin_current_status": "Registered",
       "pin_status": "Active",
       "effective_from_date": "2022-12-31",
       "effective_to_date": null,
       "itax_status": "iPage Updated",
       "obligation_name": "Income Tax - Resident Individual",
       "taxpayer_name": "Masoud Onyango",
       "requested_by": "API User"
   }
}