KRA Pin
The KE KRA_PIN id type returns the KRA pin associated with an national id number or the alien card number. Pass either the National ID Number or the Alien Card Number as the id_number when submitting the job.
Required Inputs
| Input | Value |
|---|---|
country | KE |
id_type | KRA_PIN |
id_number | National ID number or Alien card number |
citizenship | Kenyan or Alien |
Response Fields
| Response Field | Value Returned |
|---|---|
Country | YES |
IDType | YES |
IDNumber | YES (The National ID number) |
IssuanceDate | NO |
ExpirationDate | NO |
FullName | NO |
DOB | NO |
Photo | NO |
PhoneNumber | NO |
PhoneNumber2 | NO |
Secondary_ID_Number | YES (KRA Pin) |
Document | NO |
Gender | NO |
Address | NO |
All fields are returned as string
ID Number Regular Expression (Regex)
To limit the probability of your user mistyping the id number, we advice that you enforce the format of the id number field in your app. You can use the regex below:
/^[0-9]{1,9}$/
Supported Products
The Kenya national id can be used on any of the following products:
For the supported integration options, you can check the integration options supported by each product here.
Sample ID Numbers
To test the Kenya national id in our Sandbox, we provide you with 5 different id numbers to mirror various scenarios you can experience with real IDs in production.
| ID Number | Result | Result Code |
|---|---|---|
00000000 | Success with PII return | 1012 |
00000001 | Failure, no record found | 1013 |
00000002 | Invalid ID number format | 1014 |
00000003 | Database unavailable/unknown network issue | 1015 |
00000004* | Success with custom PII return | 1012 |
* You can read more about customising the PII response in sandbox in our documentation here.
Last updated
