Tax Information

The Tax Information service enables users to verify the authenticity of the KRA PIN and grants access to their tax information.

Required Inputs

Input	Value
country	KE
id_type	TAX_INFORMATION
id_number	Kra Pin

Response Fields

Response Field	Value Returned
Country	YES
IDType	YES
IDNumber	YES
IssuanceDate	NO
ExpirationDate	NO
FullName	YES
DOB	NO
Photo	NO
PhoneNumber	NO
PhoneNumber2	NO
Secondary_ID_Number	NO
Document	NO
Gender	NO
Address	YES

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:

• /^[Aa]\d{9}[a-zA-Z]$/

Supported Products

The Kenya Tax Information can be used on any of the following products:

• Enhanced KYC
• Basic KYC

For the supported integration options, you can check the integration options supported by each product here.

Sample ID Numbers

To test the Kenya Tax Information 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
A000000000A	Success with PII return	1012
A000000001A	Failure, no record found	1013
A000000002A	Invalid ID number format	1014
A000000003A	Database unavailable/unknown network issue	1015
A000000004A*	Success with custom PII return	1012

* You can read more about customising the PII response in sandbox in our documentation here.