Driving License

Look up a Kenyan driving license using the holder's national ID number.

Test data

Sandbox test data

Use these values against the sandbox host. Click a value to copy it.

National ID numbers

Sample license holder

Request

POST/api/v1/driving-license

{{baseUrl}}/api/v1/driving-license

Header

Header	Type	Description
Authorization	string	`Bearer YOUR_ACCESS_TOKEN` from the OAuth client-credentials flow
Content-Type	string	application/json

Body Parameters

Parameter	Type	Description	Required
id_number	string	National ID of the license holder	required
customer_number	string	Optional reference for your own tracking (max 255 characters)	optional

Response

200 OKSample dataExample response

{
  "success": true,
  "response_code": 200,
  "message": "Driving License Details Fetched Successfully",
  "data": {
    "full_name": "JOHN DOE",
    "first_name": "JOHN",
    "last_name": "DOE",
    "id_number": "12345678",
    "date_of_birth": "1990-01-01",
    "gender": "M",
    "citizenship": "KE",
    "verification_status": "Valid",
    "serial_number": "DL-1000001",
    "license_number": "DL-1000001",
    "dl_class": "B",
    "date_of_issue": "2020-01-01",
    "date_of_expiry": "2030-01-01",
    "status": "valid",
    "points": "20",
    "blood_group": "UNKNOWN",
    "is_valid": true,
    "phone_number": "+254700000000",
    "email": "john.doe@example.com",
    "address": "123 Sample Street",
    "city": "Nairobi",
    "postal_address": "P.O. Box 12345-00100",
    "kra_pin": "A000000000A",
    "file_reference_number": "FRN-1000001",
    "has_smart_dl": "yes",
    "id_type": "citizen",
    "loader": "NO",
    "nc_classes": "B",
    "sub_classes_of_i": "B1",
    "certificate_of_competency_number": "COC-1000001",
    "certificate_of_competency_issued_date": "2019-12-01"
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440003"
}

Response Fields

Field	Type	Description
success	boolean	Whether the request succeeded
response_code	number	Application response code (typically mirrors HTTP)
message	string	Human-readable status message
data	object	Payload for the verified resource
request_id	string	UUID for support and audit trails

Set {{baseUrl}} to https://api.peleza.com (production) or https://sandbox.peleza.com (sandbox). Authenticated calls need a Bearer token from POST /api/v1/oauth/token.