National ID

Validate a National Identification Number

Our NIN Validation endpoint allows businesses to securely and easily verify their customers' National Identification Numbers (NIN).

Key Features:

• Instant Verification: Quickly confirm the validity of the NIN.
• Detailed User Information: Receive additional user details such as name, gender, profession, address, and more.

📘

GET (LIVE)

{{URL}}/dikript/verification/api/v1/ke/nationalid

📘

GET (TEST)

{{URL}}/dikript/test/api/v1/ke/nationalid

Parameter

Key	Description
nationalid	nationalid Number

Header (LIVE)

Key	Description
x-api-key	Your Secret Key

Header (TEST)

Key	Description
x-api-key	Your Public Key

Responses

jsc

{
    "status": true,
    "message": "Successful",
    "code": "200",
    "apiVersion": "v1",
    "transactionRef": "N202507020819295118",
    "data": {
        "firstName": "John",
        "surname": "Mwangi",
        "otherName": "Kamau",
        "gender": "M",
        "dateOfBirth": "1985-03-15",
        "citizenship": "KENYAN",
        "idNumber": "24524319",
        "serialNumber": "12345678901234567890",
        "placeOfBirth": "NAIROBI",
        "placeOfDeath": "",
        "dateOfDeath": "",
        "occupation": "SOFTWARE ENGINEER",
        "photo": "/9j/4AAQSkZJRgABAQEAYABgAAD/4QA...",
        "clan": "KIKUYU",
        "ethnicGroup": "KIKUYU",
        "fingerprint": "CAPTURED",
        "pin": "A123456789Z",
        "dateOfIssue": "2020-01-15",
        "regOffice": "NAIROBI",
        "signature": "/9j/4AAQSkZJRgABAQEAYABgAAD/4QA...",
        "family": "MWANGI FAMILY",
        "address": "123 KENYATTA AVENUE, NAIROBI"
    },
    "error": {
        "code": null,
        "message": null
    }
}

JSON

{
    "message": "Unsuccessful",
    "code": "400",
    "apiVersion": "v1",
    "transactionRef": "N202401101345487388",
    "data": "",
    "error": {
        "code": 400,
        "message": null
    }
}

js

{
    "status": true,
    "message": "nin not found",
    "code": "200",
    "apiVersion": "v1",
    "transactionRef": "N202401101323024787",
    "data": {
        "firstName": "",
        "birthDate": "",
        "employmentStatus": "",
        "gender": "",
        "middleName": "",
        "nin": "",
        "vNin": "",
        "email": "",
        "otherName": "",
        "profession": "",
        "birthCountry": "",
        "otherSpokenLang": "",
        "nokFirstName": "",
        "nokLastName": "",
        "nokMiddleName": "",
        "photo": "",
        "residenceAdressLine1": "",
        "residenceAdressLine2": "",
        "residenceLga": "",
        "residenceState": "",
        "selfOriginState": "",
        "selfOriginLga": "",
        "selfOriginPlace": "",
        "signature": "",
        "surname": "",
        "telephoneNo": "",
        "title": "",
        "trackingId": ""
    },
    "error": null
}