Motor Vehicle Records

Look up Kenyan motor vehicle records by plate via POST /api/v1/mvr/ke. HTTP 200 and 404 are billable.

Request

POST/api/v1/mvr/ke

{{baseUrl}}/api/v1/mvr/ke

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
plate_number	string	Vehicle registration / plate (spaces stripped, e.g. KCA 123A → KCA123A)	required
consent	boolean	Must be true — confirms data-subject consent to perform this verification	required
customer_number	string	Optional reference for your own tracking (max 255 characters)	optional

Sample request body

All verification APIs require consent: true in the JSON body.

Sample dataSample request body

{
  "plate_number": "KAA123A",
  "consent": true
}

Response

200 OKSample dataExample response

{
  "success": true,
  "response_code": 200,
  "message": "Vehicle Details Fetched Successfully",
  "country": "ke",
  "data": {
    "reg_no": "KCA123A",
    "vehicle": {
      "make": "Toyota",
      "model": "Corolla",
      "color": "White",
      "body_type": "Saloon",
      "vehicle_type": "Motor Car",
      "purpose": "Private",
      "registration_status": "Active",
      "registration_date": "2020-01-15",
      "chassis_number": "ABC123",
      "engine_number": "ENG1",
      "engine_capacity": "1500",
      "fuel_type": "Petrol",
      "passenger_capacity": "5",
      "gross_weight": "1500",
      "tare_weight": "1100",
      "logbook_number": "LB1",
      "logbook_serial": "S1",
      "duty_status": null,
      "duty_amount": null,
      "entry": { "number": null, "CPC": null }
    },
    "owner": {
      "first_name": "JAMES",
      "middle_name": null,
      "last_name": "KAMAU",
      "full_name": "JAMES KAMAU",
      "id_number": "1028845317",
      "pin": null,
      "phone": null,
      "address": null,
      "code": null,
      "town": "Nairobi"
    },
    "is_valid": true
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440000"
}

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

Error codes

Standard Peleza HTTP / response_code values (same across all API calls). Validation message text is endpoint-specific. Full reference: Error Codes.

Code	When	Billed?
200	Vehicle details returned	Yes
400	Validation — plate_number required	No
401	Missing or invalid Bearer token	No
402	Insufficient wallet balance or credit limit	No
403	No active wallet or billing profile (or service not enabled)	No
404	Vehicle not found / unsupported country	Yes (found path) / No (unsupported)
408	Upstream timeout / service error	No
429	Rate limited	No
502	Upstream bad or unreadable response	No
503	Verification service unavailable or request timed out	No

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.