Vehículos

GET /v1/vehicles

Busca los vehículos de tu empresa. Úsalo para resolver el vehicle_id (UUID) de Uvicuo que asignas al crear un plan de gasto.

Parámetros (query)

Parámetro	Tipo	Descripción
`search`	string	Texto libre: placa, alias, marca o modelo. Si se omite, devuelve los vehículos activos.

Ejemplo

curl "https://api.sandbox.partner.uvicuo.com/v1/vehicles?search=ABC-123" \
  -H "X-API-Key: $UVICUO_API_KEY"

Respuesta

200 OK — un arreglo de vehículos:

[
  {
    "id": "7b3e0a2c-1f44-4d8e-9c0a-2b6f5e1d9a10",
    "alias": "Camión 12",
    "plate_number": "ABC-123",
    "brand_name": "Kenworth",
    "model_name": "T680",
    "vehicle_type": "TRUCK",
    "tag_status": "ACTIVE"
  }
]

Campo	Tipo	Descripción
`id`	string (UUID)	El `vehicle_id` de Uvicuo. Úsalo al crear un plan de gasto.
`alias`	string	Alias/apodo del vehículo.
`plate_number`	string	Placa.
`brand_name` / `model_name`	string	Marca y modelo.
`vehicle_type`	enum	`CAR`, `VAN`, `TRUCK`, `MOTORCYCLE`, `FORKLIFT`, `UNDEFINED`.
`tag_status`	enum	Estado del TAG: `ACTIVE`, `BLOCKED`, `INACTIVE`, `NO_TAG`.

Errores comunes

HTTP / `code`	Situación
`401 unauthorized`	Falta o es inválida la `X-API-Key`.