Tax PIN Verification
Kenyan Tax PIN Verification API
To perform verification on a Kenyan Tax PIN, make a POST request to the following endpoint;
{{baseurl}}/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"
}
}
Updated 3 months ago