History & Provenance
Full Vehicle Check
Everything in one call — details, MOT history, valuation and provenance.
Overview
The complete picture in a single request: DVLA details, full MOT history, a current valuation and the provenance risk check — merged into one normalized response.
Cheaper than calling each product separately, and one round-trip for your users.
Features
- DVLA vehicle details
- Complete MOT history
- Current market valuation
- Write-off, finance and stolen checks
- One request, one merged response
Example response
A successful lookup for AB12CDE. Illustrative values.
{
"data": {
"vrm": "AB12CDE",
"registration_number": "AB12CDE",
"make": "FORD",
"model": "FIESTA",
"colour": "BLUE",
"fuel_type": "PETROL",
"engine_capacity": 1499,
"year_of_manufacture": 2019,
"month_of_first_registration": "2019-03",
"co2_emissions": 119,
"tax_status": "Taxed",
"tax_due_date": "2026-09-01",
"mot_status": "Valid",
"mot_expiry_date": "2026-03-14",
"wheelplan": "2 AXLE RIGID BODY",
"export_marker": false,
"mot_history": [
{
"test_date": "2025-03-12",
"result": "PASSED",
"odometer": 48210,
"odometer_unit": "mi",
"expiry_date": "2026-03-14",
"advisories": [
"Nearside front tyre worn close to the legal limit"
]
},
{
"test_date": "2024-03-05",
"result": "FAILED",
"odometer": 36940,
"odometer_unit": "mi",
"expiry_date": null,
"advisories": [
"Offside rear brake disc worn"
]
}
],
"valuation": {
"trade": 6450,
"retail": 8195,
"private": 7300,
"currency": "GBP"
},
"provenance": {
"write_off": false,
"write_off_category": null,
"outstanding_finance": false,
"stolen": false,
"scrapped": false,
"exported": false
}
},
"credit_balance": 499
}
Fields returned
| Field | Type | Description |
|---|---|---|
| registration_number | string | The vehicle registration mark (VRM). |
| make | string | Manufacturer, as recorded by the DVLA. |
| model | string | Model, resolved from the MOT record where available. |
| colour | string | Current registered colour, normalised. |
| fuel_type | string | Fuel type, normalised (PETROL, DIESEL, ELECTRIC…). |
| engine_capacity | integer | Engine capacity in cc. |
| year_of_manufacture | integer | Year the vehicle was manufactured. |
| month_of_first_registration | string | Year and month the vehicle was first registered (YYYY-MM). |
| co2_emissions | integer | CO₂ emissions in g/km. |
| tax_status | string | Current tax status (Taxed, Untaxed, SORN). |
| tax_due_date | date | Date the current tax expires. |
| mot_status | string | Current MOT status. |
| mot_expiry_date | date | Expiry date of the current MOT certificate. |
| wheelplan | string | DVLA wheelplan description. |
| export_marker | boolean | Whether the vehicle is marked for export. |
| mot_history[].test_date | date | Date the test was carried out. |
| mot_history[].result | string | PASSED or FAILED. |
| mot_history[].odometer | integer | Odometer reading recorded at the test. |
| mot_history[].odometer_unit | string | mi or km. |
| mot_history[].expiry_date | date|null | Certificate expiry (null on a failure). |
| mot_history[].advisories | array | Advisory and failure notes recorded by the tester. |
| valuation.trade | integer | Trade-in value. |
| valuation.retail | integer | Forecourt / retail value. |
| valuation.private | integer | Private-sale value. |
| valuation.currency | string | ISO currency code. |
| provenance.write_off | boolean | Whether the vehicle has been written off. |
| provenance.write_off_category | string|null | Insurance write-off category (A, B, S, N). |
| provenance.outstanding_finance | boolean | Whether a finance agreement is recorded against the vehicle. |
| provenance.stolen | boolean | Police stolen marker. |
| provenance.scrapped | boolean | Recorded as scrapped. |
| provenance.exported | boolean | Recorded as exported. |
- Is this cheaper than calling each product?
-
Yes — the bundle costs fewer credits than the individual products it contains, and it is a single round-trip.
- What happens if one source is unavailable?
-
The response still returns with whatever resolved successfully — an unavailable source simply omits its block, so you never get fabricated data.