Skip to main content
The Fuel Station Balances API (Saldos Bombas) provides access to fuel station balance data, allowing you to monitor available balances across different operational areas and fuel stations.

​
Base URL

/api/saldos-bombas
All endpoints require authentication with a valid JWT token.

​
Available Endpoints

List Balances

Get all fuel station balances with filtering and sorting

Filter Options

Get available filter values for dropdowns

​
Data Model

The Saldos Bombas data represents fuel station balances: 
interface SaldoBomba {
  id: number;
  bomba_id: number;
  nombre_bomba: string;
  area_operacion_id: number;
  nombre_area_operacion: string;
  saldo_disponible: number;
  actividad: 'ACTIVADA' | 'DESACTIVADA';
  ultima_actualizacion?: string;
}

​
Common Parameters

​
Pagination

  • page - Page number (default: 1)
  • limit - Items per page (default: 20)

​
Filters

  • area_operacion - Filter by operational area name
  • bomba - Filter by fuel station name
  • actividad - Filter by status (ACTIVADA, DESACTIVADA)

​
Sorting

  • sort_by - Field to sort by (default: saldo_disponible)
  • sort_order - Sort direction (asc, desc)

​
Authentication

All endpoints require a Bearer token: 
curl https://api.example.com/api/saldos-bombas \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Common Use Cases

​
Monitor Low Balances

Track fuel stations with low available balances: 
curl "https://api.example.com/api/saldos-bombas?sort_by=saldo_disponible&sort_order=asc&limit=10" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Check Specific Area

View balances for a specific operational area: 
curl "https://api.example.com/api/saldos-bombas?area_operacion=Zona%20Norte" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Active Stations Only

By default, only active (ACTIVADA) stations are returned. To see all: 
curl "https://api.example.com/api/saldos-bombas?actividad=" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Error Responses

All endpoints follow standard HTTP status codes:
StatusDescription
200Success
400Bad request - Invalid parameters
401Unauthorized - Missing or invalid token
500Server error

​
Next Steps

View Detailed API

Explore the full API reference

Authentication

Learn about authentication

Build docs developers (and LLMs) love

Get started for freeTalk to us