Motor Vehicle Records

Look up Kenyan motor vehicle records by plate via POST /api/v1/mvr/ke. NTSA (Malipo) is the primary source; CreditInfo is used only if Malipo never submitted a billable search. HTTP 200 and 404 are billable. Cached plates still bill as vehicle-plate. HTTP 503 (provider down / timeout) is not billed. Docs and sandbox use fictional sample plates only (e.g. KSA0001A) — never real registration numbers.

Test data

Sandbox test data

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

Sample plate (fictional)

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. KSA 0001A → KSA0001A). Max 32 characters. Use sandbox sample plates only — do not use real registration numbers.	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 & response

Sample request body for Sample request & response:

Sample dataSample request body

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

Sample response for Sample request & response:

200 OKSample dataSample response

{
  "success": true,
  "response_code": 200,
  "message": "Vehicle Details Fetched Successfully",
  "country": "ke",
  "data": {
    "reg_no": "KSA0001A",
    "vehicle": {
      "make": "SAMPLE MOTORS",
      "model": "SAMPLE TRUCK XL",
      "color": "BLUE",
      "body_type": "LORRY/TRUCK",
      "vehicle_type": "MOTOR VEHICLE",
      "purpose": "COMMERCIAL",
      "registration_status": "REGISTERED",
      "registration_date": "2020-06-20",
      "year_of_manufacture": "2019",
      "chassis_number": "SAMPLECHASSIS000001",
      "engine_number": "SAMPLEENGINE000001",
      "engine_capacity": "3000",
      "fuel_type": "DIESEL",
      "passenger_capacity": "2",
      "gross_weight": null,
      "tare_weight": null,
      "logbook_number": "SAMPLELB0001",
      "logbook_serial": "202006201234567",
      "duty_status": "PAID",
      "duty_amount": "0",
      "flagged": null,
      "entry": {
        "number": "SAMPLEENTRY000001",
        "CPC": null
      }
    },
    "owner": {
      "first_name": "SAMPLE LOGISTICS LTD",
      "middle_name": null,
      "last_name": null,
      "full_name": "SAMPLE LOGISTICS LTD",
      "owner_type": "COMPANY",
      "id_number": "0001",
      "pin": "P000000001S",
      "phone": "0712345678",
      "address": "P.O. Box 100",
      "code": "00100",
      "town": "NAIROBI"
    },
    "inspection": {
      "status": "Valid",
      "date": "2026-08-05",
      "expiry_date": "2027-08-05",
      "sticker_no": "NBI202608050001",
      "type": "annual-inspection",
      "center": "Nairobi - Sample Inspection Centre"
    },
    "charges": [
      {
        "commencement_date": "2020-06-20",
        "financier_name": "SAMPLE BANK LTD",
        "financier_pin": "P000000002S"
      }
    ],
    "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
country	string	Country code from the path (ke)
data.reg_no	string	Normalised registration plate
data.vehicle.make	string	Vehicle make
data.vehicle.model	string	Vehicle model
data.vehicle.color	string	Body colour
data.vehicle.body_type	string	Body type (e.g. LORRY/TRUCK, Saloon)
data.vehicle.vehicle_type	string	Vehicle type (e.g. MOTOR VEHICLE)
data.vehicle.purpose	string	Use / purpose (e.g. COMMERCIAL, Private)
data.vehicle.registration_status	string	NTSA registration status
data.vehicle.registration_date	string\|null	First registration date (YYYY-MM-DD)
data.vehicle.year_of_manufacture	string\|null	Year of manufacture
data.vehicle.chassis_number	string	Chassis / VIN
data.vehicle.engine_number	string	Engine number
data.vehicle.engine_capacity	string	Engine capacity (cc)
data.vehicle.fuel_type	string	Fuel type
data.vehicle.passenger_capacity	string	Passenger capacity
data.vehicle.gross_weight	string\|null	Gross vehicle weight
data.vehicle.tare_weight	string\|null	Tare weight
data.vehicle.logbook_number	string	Logbook number
data.vehicle.logbook_serial	string	Logbook serial
data.vehicle.duty_status	string\|null	Customs duty status
data.vehicle.duty_amount	string\|null	Duty amount when available
data.vehicle.flagged	boolean\|null	NTSA flagged indicator when present
data.vehicle.entry.number	string\|null	Customs entry number
data.vehicle.entry.CPC	string\|null	Customs procedure code when available
data.owner.first_name	string	Owner first name (or company name for COMPANY owners)
data.owner.middle_name	string\|null	Owner middle name
data.owner.last_name	string\|null	Owner last name
data.owner.full_name	string	Owner full name
data.owner.owner_type	string\|null	Owner type (e.g. COMPANY, INDIVIDUAL)
data.owner.id_number	string	Owner national ID or company number
data.owner.pin	string\|null	Owner KRA PIN
data.owner.phone	string\|null	Owner phone
data.owner.address	string\|null	Owner postal / box address
data.owner.code	string\|null	Postal code
data.owner.town	string\|null	Owner town
data.inspection	object\|null	Latest NTSA inspection when returned
data.inspection.status	string\|null	Inspection status (e.g. Valid)
data.inspection.date	string\|null	Inspection date (YYYY-MM-DD)
data.inspection.expiry_date	string\|null	Inspection expiry date (YYYY-MM-DD)
data.inspection.sticker_no	string\|null	Inspection sticker number
data.inspection.type	string\|null	Inspection type (e.g. annual-inspection)
data.inspection.center	string\|null	Inspection centre
data.charges	array	Financiers / charges on the vehicle (empty array when none)
data.charges[].commencement_date	string\|null	Charge commencement date
data.charges[].financier_name	string\|null	Financier name
data.charges[].financier_pin	string\|null	Financier KRA PIN
data.is_valid	boolean	True when a usable vehicle record was returned

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 (NTSA or cache)	Yes — vehicle-plate
400	Validation — plate_number required (max 32); consent must be true	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 (provider was called) — billed. Unsupported country (not ke) — not billed.	Yes / No
408	Upstream timeout / service error	No
429	Rate limited	No
502	Upstream bad or unreadable response	No
503	NTSA / verification service unavailable, timed out, or duplicate submit blocked	No

404 — vehicle not found

404Sample data404 — vehicle not found

{
  "success": false,
  "response_code": 404,
  "message": "Vehicle Not Found",
  "country": "ke",
  "errors": {
    "plate_number": ["The provided plate number does not have a valid vehicle record."]
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440032"
}

503 — provider unavailable

503Sample data503 — provider unavailable

{
  "success": false,
  "response_code": 503,
  "message": "Vehicle verification service is temporarily unavailable. Please try again later.",
  "country": "ke",
  "errors": {
    "plate_number": ["Vehicle verification service is temporarily unavailable. Please try again later."]
  },
  "request_id": "550e8400-e29b-41d4-a716-446655440033"
}

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.