Skip to navigation

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.

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.

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.

StatusMeaning
200The vehicles.
202feature_not_ready — vehicles_data is still running. Only this family waits: the ones that already closed answer now.
204The execution never asked for vehicles_data. No body.
404No execution with that id for your application, or it has been deleted.

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.

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_datedateDeprecated

Deprecated: read last_registration_date and first_registration_date instead. A registration date as the source reports it, which is not always the same registration: the one in country when the source gives it, the vehicle’s first registration when the source gives only that one. Still present, and filled as before.

first_registration_datedateOptional

Date the vehicle was registered for the first time, in any country: for an imported vehicle, its original registration abroad. It belongs to the vehicle, not to its owner — a vehicle bought second hand keeps it — and it is the date that tells the vehicle’s age. Equal to last_registration_date when the vehicle was first registered in country. Absent when the source consulted does not give it — and then last_registration_date may well be the first registration too: the absence only says the source does not tell.

last_registration_datedateOptional

Date the vehicle was registered in country: the registration in force. Equal to first_registration_date for a vehicle first registered there, later for one registered abroad before. It belongs to the vehicle, not to its owner — a change of owner leaves it as it was. Absent when the source consulted does not give it — and then first_registration_date may well be the registration in country too: the absence only says the source does not tell.

inspection_expiry_datedateOptional
Expiry date of the vehicle inspection.
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

Whether the vehicle has incidents, and which ones. Present only when vehicles_data is requested with simple_vehicle_report: true in its configurations.

Errors

404
Not Found Error
422
Unprocessable Entity Error