Referencia

Referencia: Vehicles (vehículos)

Los vehículos de tu organización. Solo lectura.

GET/v1/vehicles

vehicles:read

Lista paginada, de más reciente a más antiguo.

Parámetro	Dónde	Tipo	Descripción
`active`	query	`true \| false`	Solo activos o solo inactivos.
`limit`	query	`integer`	1–100, por defecto 25.
`cursor`	query	`string`	El next_cursor anterior.

Petición

curl

curl "https://wearetransfers.com/api/v1/vehicles" \
  -H "Authorization: Bearer $WAT_API_KEY"

Respuesta

json

{
  "data": [
    {
      "id": "5f4e3d2c-1b0a-4f9e-8d7c-6b5a4f3e2d1c",
      "external_id": null,
      "plate": "1234 KLM",
      "model": "Mercedes Clase E",
      "nickname": "E-Class negro",
      "category": "sedan",
      "seats": 3,
      "luggage": 3,
      "wheelchair_adapted": false,
      "eco_label": "ECO",
      "propulsion": "hibrido",
      "active": true,
      "created_at": "2026-01-15T10:05:00.000Z"
    }
  ],
  "next_cursor": null,
  "has_more": false
}

GET/v1/vehicles/{id}

vehicles:read

Un vehículo por UUID. Ajeno: 404.

Parámetro	Dónde	Tipo	Descripción
`id *`	path	`uuid`	Id del vehículo.

Petición

curl

curl https://wearetransfers.com/api/v1/vehicles/5f4e3d2c-1b0a-4f9e-8d7c-6b5a4f3e2d1c \
  -H "Authorization: Bearer $WAT_API_KEY"

Respuesta

json

{
  "id": "5f4e3d2c-1b0a-4f9e-8d7c-6b5a4f3e2d1c",
  "external_id": null,
  "plate": "1234 KLM",
  "model": "Mercedes Clase E",
  "nickname": "E-Class negro",
  "category": "sedan",
  "seats": 3,
  "luggage": 3,
  "wheelchair_adapted": false,
  "eco_label": "ECO",
  "propulsion": "hibrido",
  "active": true,
  "created_at": "2026-01-15T10:05:00.000Z"
}

El objeto Vehicle

Campo	Tipo	Qué es
`id`	uuid	Es el assignment.vehicle.id de las reservas.
`external_id`	string \| null	Tu id para este vehículo, si lo guardaste.
`plate`	string \| null	Matrícula.
`model`	string \| null	Marca y modelo.
`nickname`	string \| null	Nombre interno.
`category`	sedan \| van \| sedan_vip \| van_vip \| null	Turismo/Minivan × Standard/VIP.
`seats · luggage`	integer \| null	Plazas y maletas máximas.
`wheelchair_adapted`	boolean	Adaptado a silla de ruedas.
`eco_label · propulsion`	string \| null	Distintivo ambiental y tipo de propulsión.
`active`	boolean	Si se le pueden asignar servicios.
`created_at`	date-time	Alta.