History & Provenance
Provenance Check
Write-off, outstanding finance, stolen and scrapped markers in one call.
Overview
The risk check: insurance write-off categories, outstanding finance agreements, stolen markers and scrappage status.
This is the call to make before money changes hands — the single highest-value check in a vehicle purchase or finance journey.
Features
- Insurance write-off category (A / B / S / N)
- Outstanding finance agreements
- Stolen (police marker) status
- Scrapped and exported markers
Example response
A successful lookup for AB12CDE. Illustrative values.
{
"data": {
"vrm": "AB12CDE",
"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 |
|---|---|---|
| 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. |