---
title: Kenya National ID
slug: us-apis/kenya-national-id
createdAt: 2024-04-12T04:01:54.142Z
---

# Overview and Purpose

## Overview

The **Kenya National ID Verification API** is a tool designed specifically for individuals in Kenya. This API provides crucial support in confirming the authenticity of personal information against official Kenyan records, enhancing trust, accuracy, and compliance.

## Key Features and Functionalities

- **Identity Verification:** The API checks personal details such as first name, last name, gender, date of birth, and national ID number against Kenya's national identity databases. This is essential for confirming the identity of individuals in processes like account creation, financial transactions, and access to services.
- **Identity Protection:** By verifying identities against official records, this API plays a vital role in preventing identity theft and fraud. It ensures that only authenticated individuals gain access to sensitive services and information.
- **Compliance Support:** The API helps businesses meet stringent regulatory requirements by providing reliable verification services that comply with Kenyan laws and guidelines.

The **Kenya National ID Verification API** secures and streamlines customer onboarding and transactions.

# API Details

## Sample cURL

:::CodeblockTabs
PreProduction

```json
curl --location 'https://api-preproduction.signzy.app/api/v3/global-kyc-verify/ke/nid' \
--header 'Authorization: <AUTH TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
    "firstName": "umar",
    "lastName": "ali",
    "middleName": "akmal",
    "dateOfBirth": "1980-01-01",
    "gender": "Male ",
    "identityInformation": {
        "nationalIdNumber": "9809065830080"
    },
    "consent": true
}
'
```

Production

```json
curl --location 'https://api.signzy.app/api/v3/global-kyc-verify/ke/nid' \
--header 'Authorization: <AUTH TOKEN>' \
--header 'Content-Type: application/json' \
--data '{
    "firstName": "umar",
    "lastName": "ali",
    "middleName": "akmal",
    "dateOfBirth": "1980-01-01",
    "gender": "Male ",
    "identityInformation": {
        "nationalIdNumber": "9809065830080"
    },
    "consent": true
}
'
```
:::

## API Input

```json
{
    "firstName": "<First Name>",
    "lastName": "<Last Name>",
    "middleName": "<Middle Name>",
    "dateOfBirth": "<Date of Birth>",
    "gender": "<Gender> ",
    "identityInformation": {
        "nationalIdNumber": "<Kenya NID Number>"
    },
    "consent": true
}
```

## Request Body Parameters

| Parameter        | Type    | Description                                              | Required/Optional |
| ---------------- | ------- | -------------------------------------------------------- | ----------------- |
| firstName        | String  | The first name of the person                             | Required          |
| lastName         | String  | The last name of the person                              | Required          |
| middleName       | String  | The middle name of the person                            | Optional          |
| dateOfBirth      | String  | Date of birth of the person in yyyy-mm-dd format         | Required          |
| gender           | String  | gender of the person Male/Female                         | Optional          |
| nationalIdNumber | String  | 7 Digit national Id number                               | Required          |
| consent          | Boolean | Consent of the end user for verification of his/her data | Required          |

## Response

```json
{
    "result": {
        "verificationResult": {
            "firstName": true,
            "lastName": true,
            "middleName": true,
            "dateOfBirth": false,
            "gender": true,
            "nationalIdNumber": true
        }
    }
}
```

## Response Body Parameters

| **Parameter**     | **Description**                                                                                                                                                            | **Data Type** |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
| `firstName`       | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean       |
| `lastName`        | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean       |
| `middleName`      | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean       |
| `gender`          | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean       |
| `dateOfBirth`     | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean       |
| `nationaIdNumber` | The API returns a Boolean value ("True" for a match found and "False" for no match found) based on the verification of the provided input data against authorized sources. | boolean       |

## Error Code and Response Mapping

:::CodeblockTabs
400 (Bad Request)

```json
{
  "error": {
     "name": "error",
     "message": "Bad Input and description ",
     "status": 400,
     "reason": "VALIDATION_ERROR",
     "type": "Bad Request",
     "statusCode": 400
  }
}
```

401(Unauthorized)

```json
{
  "error": {
     "name": "error",
     "message": "Invalid authentication credentials",
     "status": 401,
     "reason": "AUTHENTICATION_ERROR",
     "type": "Bad Request",
     "statusCode": 401
  }
}
```

403 (Forbidden)

```json
{
  "error": {
     "name": "error",
     "message": "Forbidden",
     "reason": "ERROR",
     "type": "Bad Request",
     "statusCode": "403"
  }
}
```

500 (Internal Server Error)

```json
{
  "error": {
     "name": "error",
     "message": "Internal server error",
     "status": 500,
     "reason": "ERROR",
     "type": "Bad Request",
     "statusCode": 500
  }
}
```

409(Upstream Down

```json
{
  "error": {
     "name": "error",
     "message": "Upstream Down",
     "status": 409,
     "reason": "ERROR",
     "type": "Bad Request",
     "statusCode": 409
  }
}
```
:::

| **Field**    | **Type** | **Description**                                     |
| ------------ | -------- | --------------------------------------------------- |
| `name`       | string   | Text displayed on the screen explaining error type. |
| `reason`     | string   | Reason for the error.                               |
| `status`     | number   | HTTP status code.                                   |
| `message`    | string   | Error message indicating an upstream error.         |
| `type`       | string   | Error type.                                         |
| `statusCode` | number   | Status code representing the error scenario.        |

:::hint{type="info"}
### Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [help@signzy.com](#). We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!
:::



