Drivers License

This endpoint is used to verify the details of a driver's license. It requires the license number, first name, and last name of the license holder.

Endpoint: POST {baseurl}/v1/api/verification/drivers-license

Request Body

Field Name	Type	Required	Description
country	string	Yes	The country code of the driver's license. Example: KEN. (Support: Kenya )
reference	string	Yes	A unique reference for the verification request.
identity	string	Yes	A unique identifier for the user.
verificationLevel	string	Yes	The level of verification to perform.
licenseNumber	string	Yes	The driver's license number to verify.
firstName	string	Yes	The first name of the license holder.
lastName	string	Yes	The last name of the license holder.

Example Request Body

{
    "country": "KEN",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "licenseNumber": "NHL0-09876",
    "firstName": "John",
    "lastName": "Doe"
}

Sample Request

curl

curl -X POST "{baseurl}/v1/api/verification/drivers-license" \
-H "Content-Type: application/json" \
-H "x-api-key: {API-KEY}" \
-d '{
    "country": "KEN",
    "reference": "0122333444455555",
    "identity": "6791457be570f7f292f1fe23",
    "verificationLevel": "basic",
    "licenseNumber": "NHL0-09876",
    "firstName": "John",
    "lastName": "Doe"
}'

Sample Response

{
        "status": true,
        "responseCode": "00",
        "statusCode": "200",
        "message": "Driver's License verification successful",
        "data": {
                "licenseNumber": "NID123456789",
                "firstName": "John",
                "lastName": "Smith",
                "dateOfBirth": "1990-01-01",
                "gender": "Male",
                "photo": "base64encodedimage",
                "expiryDate": "2030-01-01",
                "issueDate": "2020-01-01"
        },
        "meta": {
                "statusCode": "200",
                "isValid": true,
                "timeStamp": "Thu Apr 24 2025 12:36:07 GMT+0000 (Coordinated Universal Time)"
        }
}