API REST

Consultas DGT para carteras de miles de vehículos.

Integra las consultas de tu stock o flota mediante lotes de matrículas. Sigue cada solicitud, recupera el resumen JSON tras el análisis y descarga el PDF oficial cuando esté disponible.

Solicitar acceso a la API

Un contrato pensado para integrar

Acceso por empresa

Tokens Bearer con permisos definidos y revocación desde el portal de empresa.

Resumen JSON y PDF

El detalle del informe expone 17 campos del vehículo tras el análisis y acceso al PDF disponible. Los resultados pueden ser nulos mientras se procesan.

Lotes asíncronos

POST /reports/batch acepta un array plates y responde 202. Cada lote está sujeto al límite configurado y se procesa en segundo plano.

Idempotencia y seguimiento

Idempotency-Key identifica tus solicitudes. Consulta después su estado, progreso y resultado mediante GET.

/v1

Endpoints principales

API REST versionada en /api/v1, con autenticación por token, límites y un modelo de errores documentado.

Autenticación

Token Bearer vinculado a una empresa, con permisos que limitan las operaciones disponibles. Puedes revocar una credencial desde el portal sin afectar a las demás.

Authorization: Bearer <token>

reports	Solicita un informe DGT, lístalos, lee uno, descarga su PDF.
reports/batch	Envía muchas matrículas de una vez; la carga se ejecuta fuera de la petición.
usage	Saldo, plan y el libro de movimientos.
vehicles	Tu flota. Opcional, porque solicitar un informe ya registra su vehículo.
locations · departments · subsidiaries · batches	Cómo se organiza la flota.

Ejemplo de solicitud de 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"}'

Respuesta inicial: pendiente de procesamiento

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

Modelo de errores

Errores JSON consistentes, con códigos estables mapeados desde las excepciones internas.

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

Referencia completa de la API

Todos los endpoints, cuerpos de petición, campos de respuesta y códigos de error, generados a partir de la propia API. Inicia sesión para leerla; si aún no tienes cuenta, solicita acceso primero.

Abrir la referencia

¿Listo para integrar?

Cuéntanos tu volumen de consultas y la integración que necesitas. Te ayudamos a preparar el acceso para tu empresa.

Solicitar acceso a la API