Skip to main content
The Catalogos API provides access to various catalog data used throughout the fleet management system. All catalog endpoints require authentication.

​
Base URL

/api/catalogos

​
Authentication

All catalog endpoints require authentication using a Bearer token in the Authorization header: 
Authorization: Bearer <your-token>

​
Available Catalogs

The following catalog endpoints are available:
  • Areas - Operational areas
  • Drivers - Driver catalog (conductores)
  • Vehicles - Vehicle plates (placas)
  • Pumps - Fuel pumps (bombas)
  • Pump Balance - Query available balance for a pump

​
Common Response Format

Catalog endpoints return arrays of objects with the following structure: 
[
  {
    "id": 1,
    "nombre": "Catalog Item Name"
  }
]

​
Error Responses

All endpoints may return the following error responses:
​
error
string
Error message describing what went wrong

​
Common Error Codes

  • 400 - Bad Request (invalid parameters or database error)
  • 401 - Unauthorized (missing or invalid authentication token)
  • 500 - Internal Server Error

​
Example Request

curl https://api.example.com/api/catalogos/areas \
  -H "Authorization: Bearer <your-token>"

Build docs developers (and LLMs) love

Get started for freeTalk to us