Skip to navigation
Data modelsDriver & Vehicles

Driver

The person’s driving record, from the Spanish traffic authority (DGT)

View as Markdown

Where it lives: in the Spain Public Administration results, at data.driver.data. APIs with dedicated per-product results endpoints return this model directly.

The driving record answers “can this person drive, and how well”: the licenses they hold, their points balance, and how that balance has moved. A core signal for mobility, insurance and fleet-related risk checks.

product"driver_data"Required
sub_family"driver_data:eu_driver_data"Required
fetch_datestringRequiredformat: "datetime"
Date this product was fetched
countrystringRequiredformat: "country"
Country that expired the license.
licenceslist of objectsRequired
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.

Licenses

Each license the person holds:

categorystringRequired
Class of driving license.
datedateRequired
Granted date.
expiresdateOptional
Expiry date.

Point movements

Each change in the points balance, most recent first:

descriptionstringRequired
Description of the movement.
datedateRequired

Date of firmness (legal date).

points_deltaintegerRequired

Points added or subtracted (signed integer).

balance_afterintegerRequired
Balance after the movement.
effective_datedateOptional
Effective date of the movement.
infraction_referencestringOptional
Reference number of the infraction.
infraction_datedateOptional
Date of the infraction.
authority_namestringOptional
Name of the authority.
authority_codestringOptional
Code of the authority.

The person’s photograph

When the record is read through the DGT’s own connection, attachments carries the person’s photograph as the DGT holds it — an attachment of type attachment:person-certified-photo. It is there whenever the person is registered with the DGT, which happens when they hold a driving licence.

It is a photograph the State controls, which makes it a useful official reference: for example, to compare against a selfie in an identity check, or as supporting evidence in a KYC review. How you use it is your decision.