Lookup Kenya National ID

Verify a Kenyan National ID and fetch holder details from the national registry using the ID number.

Request

[GET]

{{baseURL}}/api/v1/ke/kyc/id

Header

Header	Type	Description
AppId	string	Create an app to get your app ID on dashboard here
Authorization	string	Private/secret key. Use <key> not Bearer <key>

Query parameter

Parameter	Type	Description	Required
id *	string	The national ID number	required

Sample response

Response

{
  "entity": {
    "date_of_birth": "1996-02-21",
    "first_name": "John",
    "gender": "M",
    "id": "123456789",
    "is_date_of_birth_match": true,
    "is_first_name_match": true,
    "is_gender_match": true,
    "is_last_name_match": true,
    "is_middle_name_match": true,
    "last_name": "Doe",
    "middle_name": "Donald"
  }
}

Response Fields

Field	Type	Description
entity	object	Contains the verification response data
entity.date_of_birth	string	Date of birth of the individual (yyyy-MM-dd)
entity.first_name	string	First name of the individual
entity.gender	string	Gender of the individual
entity.id	string	National ID number
entity.is_date_of_birth_match	boolean	Whether the provided date of birth matches the record
entity.is_first_name_match	boolean	Whether the provided first name matches the record
entity.is_gender_match	boolean	Whether the provided gender matches the record
entity.is_last_name_match	boolean	Whether the provided last name matches the record
entity.is_middle_name_match	boolean	Whether the provided middle name matches the record
entity.last_name	string	Last name of the individual
entity.middle_name	string	Middle name of the individual