Skip to main content
The Fleet Management API provides endpoints for managing your vehicle fleet, including retrieving vehicle information, syncing vehicles from active plates, and accessing vehicle catalogs.

​
Base Path

All fleet management endpoints are prefixed with /flota.

​
Authentication

All endpoints require authentication via Bearer token. Include the access token in the Authorization header: 
Authorization: Bearer <access_token>

​
Available Endpoints

List Vehicles

Retrieve all vehicles with filtering options

Vehicle Details

Get detailed information about a specific vehicle

Sync Vehicles

Sync vehicles from active plates

Vehicle Catalogs

Access vehicle brand, type, class, and fuel catalogs

​
Data Models

​
Vehiculo

The main vehicle entity with the following structure:
​
id
number
required
Unique identifier for the vehicle
​
placa_id
number
required
Reference to the vehicle’s license plate
​
empresa_id
number
Reference to the company that owns the vehicle
​
operacion_id
number
Reference to the operation area
​
created_at
string
Timestamp when the vehicle was created
​
areas_placas
object
License plate information
​
empresas
object
Company information
​
areas_operacion
object
Operation area information
​
vehiculo_caracteristicas
object
Vehicle characteristics and specifications

​
Common Query Parameters

Many fleet endpoints support filtering by:
  • empresa_id - Filter by company
  • operacion_id - Filter by operation area
  • placa - Search by license plate (partial match)

​
Error Handling

All endpoints return standard HTTP status codes:
  • 200 - Success
  • 400 - Bad Request
  • 401 - Unauthorized
  • 404 - Resource Not Found
  • 500 - Internal Server Error
Error responses include a descriptive message: 
{
  "error": "Internal Server Error",
  "details": "Description of the error"
}

Build docs developers (and LLMs) love

Get started for freeTalk to us