Owned vehicles

View as Markdown
The vehicles registered to your customer, from the Spanish traffic authority (DGT). One entry per vehicle: identification, insurance situation, roadworthiness inspection and administrative state. Field by field in [Vehicles](/guides/data-models/vehicles). <Tip> **It reads both ways.** As asset verification — what they own — and as a liability check: an uninsured vehicle, or one overdue for inspection, shows up here. </Tip> <Note title="Requires the `vehicles_data` feature"> Features are chosen when the execution **starts**, not here. An execution that did not ask for `vehicles_data` answers `204`, and the only way to get the data is to run another one. </Note> | Status | Meaning | | :--- | :--- | | `200` | The vehicles. | | `202` | `feature_not_ready` — `vehicles_data` is still running. **Only this family waits**: the ones that already closed answer now. | | `204` | The execution never asked for `vehicles_data`. No body. | | `404` | No execution with that id for your application, or it has been deleted. | <Note> **Server to server only.** This call is authorised with your application secret: it belongs in your backend, never in a browser, a mobile app or anything your customer can read. </Note>

Authentication

X-APP-SECRETstring
Application Secret

Path parameters

execution_idstringRequiredformat: "object-id"
The execution, as the acceptance response returned it.

Response

200 OK
Vehicles registered in your customer’s name: plate, make, model, registration date and the administrative state the register reports for each one.

An empty list is an answer, not a gap: the feature ran and the source reported none.

product"driver_data"
sub_family"driver_data:eu_owned_vehicle"
fetch_datestringformat: "datetime"
Date this product was fetched
countrystringformat: "country"
Country where the vehicle is registered.
registration_datedate
Registration date of the vehicle.
inspection_expiry_datedateOptional
inspection_pendingbooleanOptional
If true, the vehicle has failed the previous inspection or is pending to be inspected.
license_platestringOptional
License plate number of the vehicle.
administrative_situationstringOptional
Current administrative situation of the vehicle.
vinstringOptional
Vehicle Identification Number.
makestringOptional
Vehicle manufacturer.
modelstringOptional
Vehicle model name.
trimstringOptional

Specific vehicle trim/variant.

colorstringOptional
Color of the vehicle.
mileageintegerOptional>=0
mileage_datedateOptional
Date when the mileage was recorded.
fuel_typestringOptional
Fuel type of the vehicle.
emission_classstringOptional
Emission class of the vehicle.
insuranceobjectOptional
Vehicle insurance policy.
simple_vehicle_reportobjectOptional
Simple vehicle report.

Errors

404
Not Found Error
422
Unprocessable Entity Error