Vehicle provenance API — write-off, outstanding finance and stolen checks

Overview

Features

• Insurance write-off category (A / B / S / N) and the date recorded
• Outstanding finance agreements, with a count
• Stolen (police marker) status
• Scrappage, Certificate of Destruction, import and export records
• Keeper history: previous keepers, latest keeper change and V5C dates
• Every recorded odometer reading, with a mileage-anomaly flag
• Plate transfers and colour changes
• Last five characters of the VIN, to check against the vehicle

Example response

A successful lookup for AB12CDE. Illustrative values.

{
    "data": {
        "vrm": "AB12CDE",
        "provenance": {
            "write_off": false,
            "write_off_category": null,
            "write_off_date": null,
            "outstanding_finance": false,
            "finance_agreement_count": 0,
            "stolen": false,
            "scrapped": false,
            "scrapped_date": null,
            "certificate_of_destruction": false,
            "exported": false,
            "export_date": null,
            "imported": false,
            "import_date": null,
            "imported_from_outside_eu": false,
            "keeper": {
                "previous_keeper_count": 2,
                "latest_keeper_change_date": "2023-04-18T00:00:00Z",
                "latest_v5c_issued_date": "2023-04-21T00:00:00Z"
            },
            "mileage": {
                "anomaly_detected": false,
                "record_count": 3,
                "records": [
                    {
                        "date": "2022-05-14T09:31:22Z",
                        "mileage": 24118,
                        "source": "MOT"
                    },
                    {
                        "date": "2023-05-20T11:02:48Z",
                        "mileage": 33042,
                        "source": "MOT"
                    },
                    {
                        "date": "2024-05-22T14:15:03Z",
                        "mileage": 41967,
                        "source": "MOT"
                    }
                ]
            },
            "plate_changes": {
                "count": 1,
                "records": [
                    {
                        "date": "2021-09-02T00:00:00Z",
                        "previous_vrm": "XY09ZZZ",
                        "current_vrm": "AB12CDE"
                    }
                ]
            },
            "colour_changes": {
                "count": 1,
                "previous_colour": "Blue",
                "latest_change_date": "2020-11-30T00:00:00Z"
            },
            "vin_last_5": "48213"
        }
    },
    "credit_balance": 499
}

Fields returned