Skip to navigation
Fetching the resultsPublic administration

Driver data

View as Markdown

Your customer’s driving record, from the Spanish traffic authority (DGT).

The licences they hold, their points balance and how that balance has moved. A core signal for mobility, insurance and fleet onboarding. Field by field in Driver.

Requires the driver_data feature

Features are chosen when the execution starts, not here. An execution that did not ask for driver_data answers 204, and the only way to get the data is to run another one.

StatusMeaning
200The driving record.
202feature_not_ready — driver_data is still running. Only this family waits: the ones that already closed answer now.
204The execution never asked for driver_data, or it did and the source had nothing to give. No body either way.
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
Your customer’s licence as the traffic authority holds it: the classes they may drive, the dates each was granted and expires, and the points balance where the country runs one.

product"driver_data"
sub_family"driver_data:eu_driver_data"
fetch_datestringformat: "datetime"
Date this product was fetched
countrystringformat: "country"
Country that expired the license.
licenceslist of objects
List of driving licenses.
point_balanceintegerOptional0-20
Balance of the driver in points.
namestringOptional
First name of the driver
name_extrastringOptional
Last name of the driver.
identifierobjectOptional
NIF of the driver.
dangerous_goods_authorizedbooleanOptional
Whether the driver is authorized to transport dangerous goods.
school_transport_authorizedbooleanOptional
Whether the driver is authorized to transport school goods.
addressstringOptional
Address of the driver.
point_movementslist of objectsOptional
List of movements. If not present means the data was not consulted.
attachmentslist of objectsOptionalDefaults to []

Supporting documents of this driver record. With the DGT’s own connection, the person’s photograph as the DGT holds it (attachment:person-certified-photo), when they are registered there — that is, when they hold a driving licence.

Errors

404
Not Found Error
422
Unprocessable Entity Error