API REST

Consultes DGT per a carteres de milers de vehicles.

Integra les consultes del teu estoc o flota mitjançant lots de matrícules. Segueix cada sol·licitud, recupera el resum JSON després de l’anàlisi i descarrega el PDF oficial quan estigui disponible.

Sol·licitar accés a l'API

Un contracte pensat per integrar

Accés per empresa

Tokens Bearer amb permisos definits i revocació des del portal d’empresa.

Resum JSON i PDF

El detall de l’informe exposa 17 camps del vehicle després de l’anàlisi i accés al PDF disponible. Els resultats poden ser nuls mentre es processen.

Lots asíncrons

POST /reports/batch accepta un array plates i retorna 202. Cada lot està subjecte al límit configurat i es processa en segon pla.

Idempotència i seguiment

Idempotency-Key identifica les teves sol·licituds. Consulta’n després l’estat, el progrés i el resultat mitjançant GET.

/v1

Endpoints principals

API REST versionada a /api/v1, amb autenticació per token, límits i un model d’errors documentat.

Autenticació

Token Bearer vinculat a una empresa, amb permisos que limiten les operacions disponibles. Pots revocar una credencial des del portal sense afectar les altres.

Authorization: Bearer <token>

reports	Sol·licita un informe DGT, llista'ls, llegeix-ne un, descarrega'n el PDF.
reports/batch	Envia moltes matrícules d'una vegada; la càrrega s'executa fora de la petició.
usage	Saldo, pla i el llibre de moviments.
vehicles	La teva flota. Opcional, perquè sol·licitar un informe ja en registra el vehicle.
locations · departments · subsidiaries · batches	Com s'organitza la flota.

Exemple de sol·licitud d’informe

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"}'

Resposta inicial: pendent de processament

{
  "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
}

Model d'errors

Errors JSON consistents, amb codis estables mapats des de les excepcions internes.

{
  "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

Referència completa de l'API

Tots els endpoints, cossos de petició, camps de resposta i codis d'error, generats a partir de la mateixa API. Inicia sessió per llegir-la; si encara no tens compte, sol·licita accés primer.

Obrir la referència

A punt per integrar?

Explica’ns el volum de consultes i la integració que necessites. T’ajudem a preparar l’accés per a la teva empresa.

Sol·licitar accés a l'API