Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/JorLOrT/rappi2/llms.txt

Use this file to discover all available pages before exploring further.

The Vehicles API manages the physical fleet used for deliveries. Unlike most resources in the Rappi2 API, vehicles are identified by their placa (licence plate string) rather than an integer ID — use the plate value wherever a path parameter is shown as {placa}. Deleting a vehicle performs a soft delete, setting activo = false and estado = Inactivo.

​
Vehicle states

StateDescription
OperativoVehicle is ready and can be assigned to deliveries.
MantenimientoVehicle is temporarily out of service for maintenance.
InactivoVehicle is permanently decommissioned (soft-deleted).
Only vehicles in Operativo state can be assigned to drivers via PATCH /conductores/{id}/vehiculo or used in new assignments.

​
List vehicles

​
GET /api/vehiculos
string
Returns a paginated list of vehicles, optionally filtered by active status or operational state. Required permission: vehiculos:read

​
Query parameters

​
skip
integer
default:"0"
Number of records to skip for pagination.
​
limit
integer
default:"50"
Maximum number of records to return. Hard cap: 200.
​
activo
boolean
default:"true"
Filter by active status.
​
estado
string
Filter by operational state: Operativo, Mantenimiento, or Inactivo.

​
Response 200

Array of vehicle objects.
​
placa
string
required
Licence plate — the unique primary key for this resource.
​
tipo
string
required
Vehicle category (e.g. moto, camioneta, furgon).
​
capacidad_kg
number
required
Maximum payload capacity in kilograms.
​
estado
string
required
Operational state: Operativo, Mantenimiento, or Inactivo.
​
fecha_mantenimiento
string (datetime)
Timestamp of the last or next scheduled maintenance (ISO 8601).
​
activo
boolean
required
Whether the vehicle record is active.
curl "https://api.rappi2.com/api/vehiculos?estado=Operativo" \
  -H "Authorization: Bearer <token>"

​
Create a vehicle

​
POST /api/vehiculos
string
Registers a new vehicle in the fleet. Returns 400 if the plate is already registered. Required permission: vehiculos:write

​
Request body

​
placa
string
required
Licence plate. Maximum 15 characters. Must be unique.
​
tipo
string
required
Vehicle category.
​
capacidad_kg
number
required
Maximum payload in kilograms.
​
estado
string
default:"Operativo"
Initial operational state: Operativo, Mantenimiento, or Inactivo.
​
fecha_mantenimiento
string (datetime)
Maintenance date (ISO 8601 timestamp).

​
Response 201

The newly created vehicle object. 
curl -X POST https://api.rappi2.com/api/vehiculos \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "placa": "ABC-123",
    "tipo": "moto",
    "capacidad_kg": 50.00,
    "estado": "Operativo"
  }'

​
Get a vehicle

​
GET /api/vehiculos/{placa}
string
Returns a single vehicle by its licence plate. Returns 404 if not found. Required permission: vehiculos:read

​
Path parameters

​
placa
string
required
Licence plate of the vehicle.

​
Response 200

Vehicle object. 
curl https://api.rappi2.com/api/vehiculos/ABC-123 \
  -H "Authorization: Bearer <token>"

​
Update a vehicle

​
PATCH /api/vehiculos/{placa}
string
Partially updates a vehicle record. Only fields provided in the request body are changed. Required permission: vehiculos:write

​
Path parameters

​
placa
string
required
Licence plate of the vehicle.

​
Request body

All fields are optional.
​
tipo
string
New vehicle category.
​
capacidad_kg
number
New payload capacity in kilograms.
​
estado
string
New operational state: Operativo, Mantenimiento, or Inactivo.
​
fecha_mantenimiento
string (datetime)
Updated maintenance timestamp.
​
activo
boolean
Toggle the active flag.

​
Response 200

Updated vehicle object. 
curl -X PATCH https://api.rappi2.com/api/vehiculos/ABC-123 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"estado": "Mantenimiento", "fecha_mantenimiento": "2026-06-01T08:00:00Z"}'

​
Decommission a vehicle

​
DELETE /api/vehiculos/{placa}
string
Soft-deletes the vehicle by setting activo = false and estado = Inactivo. The record is preserved in the database. Required permission: vehiculos:delete

​
Path parameters

​
placa
string
required
Licence plate of the vehicle.

​
Response 204

No body. 
curl -X DELETE https://api.rappi2.com/api/vehiculos/ABC-123 \
  -H "Authorization: Bearer <token>"

Build docs developers (and LLMs) love

Get started for freeTalk to us