REST API

DGT-aanvragen voor bestanden met duizenden voertuigen.

Integreer aanvragen voor je voorraad of wagenpark via batches met kentekens. Volg elke aanvraag, haal de JSON-samenvatting op na analyse en download de officiële PDF zodra die beschikbaar is.

API-toegang aanvragen

Een interface voor integratie

Bedrijfstoegang

Bearer-tokens met vastgelegde rechten en intrekking via het bedrijfsportaal.

JSON-samenvatting en PDF

De rapportdetails bieden na analyse 17 voertuigvelden en toegang tot de beschikbare PDF. Resultaten kunnen null zijn tijdens de verwerking.

Asynchrone batches

POST /reports/batch accepteert een plates-array en geeft 202 terug. Elke batch blijft binnen de ingestelde limiet en wordt op de achtergrond verwerkt.

Idempotentie en voortgang

Idempotency-Key identificeert je aanvragen. Vraag daarna de status, voortgang en het resultaat op via GET.

/v1

Belangrijkste endpoints

REST-API met versies onder /api/v1, tokenauthenticatie, limieten en een gedocumenteerd foutmodel.

Authenticatie

Een Bearer-token is gekoppeld aan een bedrijf, met rechten die de beschikbare bewerkingen beperken. Je kunt één API-credential in het portaal intrekken zonder andere te beïnvloeden.

Authorization: Bearer <token>

reports	Vraag een DGT-rapport aan, geef ze weer, lees er een uit, download de PDF.
reports/batch	Dien veel kentekens tegelijk in; de verwerking loopt buiten het verzoek.
usage	Saldo, abonnement en het grootboek van bewegingen.
vehicles	Je wagenpark — optioneel, want een rapport aanvragen registreert het voertuig al.
locations · departments · subsidiaries · batches	Hoe het wagenpark is georganiseerd.

Voorbeeld van een rapportaanvraag

curl -X POST https://veriflota.es/api/v1/reports \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{"plate":"1234BCD"}'

Eerste antwoord: in afwachting van verwerking

{
  "id": "01M0ANQ0DFADGVM5PV26ZYV3YX",
  "plate": "1234BCD",
  "status": "placed",
  "progress": "queued",
  "requester": { "type": "api_credential", "name": null },
  "placedAt": "2026-08-19T09:14:22+00:00",
  "settledAt": null,
  "outcome": { "returnCode": null, "documentAvailable": false },
  "vehicle": null
}

Foutmodel

Consistente JSON-fouten met stabiele machinecodes, afgeleid van de interne excepties.

{
  "error": {
    "code": "insufficient_report_balance",
    "message": "Not enough reports left on this account.",
    "details": { "needed": 5, "available": 2, "shortfall": 3 }
  }
}

unauthenticatedinsufficient_scopevalidation_failedinsufficient_report_balancereport_already_in_flightidempotency_key_reusedrate_limited

Volledige API-referentie

Elk endpoint, elke verzoekbody, elk responsveld en elke foutcode — gegenereerd vanuit de API zelf. Log in om de referentie te lezen; heb je nog geen account, vraag dan eerst toegang aan.

De referentie openen

Klaar om te integreren?

Vertel ons over je aanvraagvolume en de gewenste integratie. We helpen je de toegang voor je bedrijf voor te bereiden.

API-toegang aanvragen