National ID Verification

This endpoint is used to verify the details of a national ID. It requires the national ID number, first name, and last name of the ID holder.

Endpoint: POST {baseurl}/v1/api/verification/national-id

Request Body

Field Name	Type	Required	Description
`country`	string	Yes	The country code of the national ID. Example: `KEN`. (Support: Kenya, and Ghana)
`reference`	string	Yes	A unique reference for the verification request. Example: `0122333444455555`.
`identity`	string	Yes	A unique identifier for the user. Example: `6791457be570f7f292f1fe23`.
`verificationLevel`	string	Yes	The level of verification to perform. Example: `basic`.
`nationalId`	string	Yes	The national ID number to verify. Example: `1234567890`.
`firstName`	string	Yes	The first name of the national ID holder. Example: `John`.
`lastName`	string	Yes	The last name of the national ID holder. Example: `Doe`.

Example Request Body

{
    "country": "KEN",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "nationalId": "1234567890",
    "firstName": "John",
    "lastName": "Doe"
}

Sample Request

curl

curl -X POST "{baseurl}/v1/api/verification/verify-national-id" \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
    "country": "KEN",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "nationalId": "1234567890",
    "firstName": "John",
    "lastName": "Doe"
}'

Sample Response

{
    "status": true,
    "responseCode": "00",
    "statusCode": "200",
    "message": "National ID verification successful",
    "data": {
        "identityNumber": "1234567890",
        "firstName": "John",
        "lastName": "Doe",
        "otherName": "Smith",
        "citizenship": "Nigerian",
        "dateOfBirth": "1990-01-01",
        "gender": "Male",
        "placeOfBirth": "Lagos",
        "occupation": "Software Engineer",
        "placeOfResidence": "Lagos",
        "serialNumber": "SN123456",
        "expiryDate": "2030-01-01",
        "issueDate": "2020-01-01"
    },
    "meta": {
        "statusCode": "200",
        "isValid": true,
        "timeStamp": "Thu Apr 24 2025 12:32:57 GMT+0000 (Coordinated Universal Time)"
    }
}