Verification ChecksBusiness & compliance
KRA PIN verification
Confirm an active KRA PIN using a Kenyan national ID.
Send KRA_PIN in checksRequested to run this check.
For a person, the national ID may be used to retrieve the PIN. To verify a
known PIN directly, send checkInputs.kraPin.
The request
{
"subject": {
"fullName": "Example Holdings Limited",
"idNumber": "PVT-5M198M5B",
"email": "company@example.com",
"country": "KE",
"subjectType": "BUSINESS"
},
"checksRequested": [
"KRA_PIN"
],
"checkInputs": {
"kraPin": "P051234567A"
},
"purpose": "Tax compliance verification",
"consent": {
"mode": "VERIFISHA_HOSTED"
}
}The acknowledgement
Creation is asynchronous. The report comes back as a draft; the check runs after.
{
"reports": [
{
"id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
"status": "DRAFT",
"paymentState": {
"status": "NOT_REQUIRED",
"amount": {
"amount": 0.1,
"currency": "KES"
}
},
"consentState": {
"status": "NOT_REQUIRED"
}
}
],
"count": 1
}The result
When the check finishes, this arrives at your webhook. COMPLETED means it
ran — read riskLevel and flags to decide what it found.
Related
- Run a Verification — this check's endpoints, with a playground
- Webhooks — the delivery, its headers and signature
- Statuses and outcomes — what the result means
GET /checks/definitions— price, inputs and availability for your workspace