Kenya National ID

Verify a customer's identity using their Kenya National ID by the National Registration Bureau (NRB).

{{baseUrl}}/v1/ke/identities/kenya-id/{idNumber}

Path Parameter

ParameterTypeDescription
IdNumber *
(REQUIRED)
stringKenya National Identity Number

Request Body

POST ParameterTypeDescription
firstname
(REQUIRED)
stringFirst Name
lastname
(REQUIRED)
stringLast Name
middlename (OPTIONAL)stringMiddle Name
dob
(OPTIONAL)
dateStringDate Of Birth (YYYY-MM-DD)
phone
(OPTIONAL)
stringPhone Number
email
(OPTIONAL)
stringEmail Address
gender
(OPTIONAL)
stringGender

This endpoint will return all bio-data information captured. To conduct an actual test

Response Sample

{
  "national_id": "22550645",
  "full_name": "AKENNA ANTHONY NGINA",
  "gender": "F",
  "surname": "AKENNA",
  "date_of_birth": "12-12-1981",
  "transunion_log": {
    "createdAt": 1673445763,
    "updatedAt": 1673445763,
    "id": 2836141,
    "nationalId": "22550645",
    "transunionResponse": "{\"alsoKnownAsList\":[],\"header\":{\"crbName\":\"Credit Reference Bureau Africa Limited T/A TransUnion\",\"pdfId\":\"123514686-da4361a2-e602-4253-83fb-4849cde7000d\",\"productDisplayName\":\"ID Decision\",\"reportDate\":1673445764000,\"reportType\":\"PERSONAL_REPORT\",\"requestNo\":123514686,\"requester\":\"Pezesha\"},\"personalProfile\":{\"alienID\":null,\"crn\":5586374,\"dateOfBirth\":376952400000,\"dateOfDeath\":null,\"drivingLicenseNo\":null,\"fullName\":\"WAMBUA FRANCISCA NGINA\",\"gender\":\"F\",\"healthInsuranceNo\":null,\"maritalStatus\":null,\"nationalID\":\"22550645\",\"nationality\":\"KENYA\",\"otherNames\":\"FRANCISCA NGINA\",\"passportNo\":null,\"pin\":null,\"salutation\":\"MS\",\"serviceID\":null,\"socialSecurityNo\":null,\"surname\":\"WAMBUA\"},\"responseCode\":200,\"summary\":{\"creditActive\":false}}",
    "transunionStatusCode": 200,
    "product": "PRODUCT121",
    "transunionRequestHandler": {
      "createdAt": 1673445763,
      "updatedAt": 1673445763,
      "id": 1128263,
      "request": "{\"identifier_type\":\"national_id\",\"identifier\":\"22550645\",\"callback_url\":null}",
      "callbackUrl": null,
      "product": "PRODUCT121",
      "refId": "9d3c29dd-196d-4a1e-b3e4-ccc59bda2363",
      "callbackStatus": 1,
      "requestertype": "MFI",
      "requesterId": 74
    }
  },
  "other_names": "FRANCISCA NGINA"
}