Estás en: Documentación › Gestión › Listar vehículos
Listar vehículos
Parámetros que acepta este endpoint y campos que devuelve.
GET
/v1/vehiclesPermiso necesario en la clave: vehicles:read (o *).
Parámetros de ruta
Este endpoint no tiene parámetros de ruta.
Parámetros de consulta
Van en la dirección, detrás de ? y separados por &. Todos son opcionales.
| Nombre | Tipo | Obligatorio | Qué hace | Ejemplo |
|---|---|---|---|---|
q | texto | No | Búsqueda de texto libre. Compara con los campos principales del recurso (nombre, código, NIF, matrícula…). | martin |
plate | texto | No | Matrícula exacta. Se ignoran espacios y guiones. | 1234ABC |
customer_id | número entero | No | Identificador del cliente (campo «id» de /customers). | 341 |
updated_since | fecha y hora ISO 8601 | No | Solo registros creados o modificados desde ese momento (ISO 8601 UTC). Sirve para sincronizar solo cambios. | 2026-11-01T00:00:00Z |
limit | número entero | No | Cuántos registros devuelve cada página (1 a 100). Por defecto 25. | 50 |
page | número entero | No | Número de página, empezando en 1. Con meta.has_more = true hay más páginas. | 1 |
Campos de la respuesta
| Campo | Tipo | Qué contiene |
|---|---|---|
id | número entero | Identificador interno del vehículo. |
plate | texto | Matrícula. |
vin | texto | Número de bastidor. |
make | texto | Marca. |
model | texto | Modelo. |
engine_cc | número entero | Cilindrada en cm³. |
power_kw | número | Potencia en kW. |
fuel | texto | Combustible. |
propulsion | texto | Tipo de propulsión. |
euro_category | texto | Categoría Euro. |
environmental_label | texto | Distintivo ambiental DGT. |
co2_g_km | número | Emisiones de CO₂ en g/km. |
body | texto | Carrocería. |
seats | número entero | Plazas. |
color | texto | Color. |
first_registration | fecha AAAA-MM-DD | Primera matriculación (AAAA-MM-DD). |
last_itv | fecha AAAA-MM-DD | Última ITV (AAAA-MM-DD). |
mileage_km | número entero | Kilómetros. |
active | sí / no | true si está activo. |
customer_id | número entero | Propietario actual (cuando se conoce). |
created_at | fecha y hora ISO 8601 | Alta. Fecha y hora ISO 8601 en UTC. |
updated_at | fecha y hora ISO 8601 | Última modificación. Fecha y hora ISO 8601 en UTC. |