Fuel Management

Plan fueling orders, manage them and track costs.

Fuel Order Object

FeldTypPflichtBeschreibung
idintegerOptionalUnique order ID
airportstringPflichtAirport (IATA)z.B. FRA
aircraft_idstringPflichtAircraft registrationz.B. D-AIMK
flight_numberstringOptionalAssociated flight numberz.B. LH1234
amount_kgnumberPflichtRequested fuel quantity in kilograms
fuel_typeenumPflichtjet_a1 | avgas | sustainable_aviation_fuel
scheduled_atdatetimePflichtScheduled fueling time (UTC, ISO 8601)
actual_amount_kgnumber|nullOptionalActual quantity fueled (after fueling)
cost_usdnumber|nullOptionalCost in USD
supplierstring|nullOptionalFuel supplierz.B. Shell Aviation
statusenumOptionalpending | confirmed | completed | cancelled
created_atdatetimeOptionalCreation timestamp

GET /fuel/orders — List Orders

GEThttps://api.aeroselect.io/api/v1/aeroops/fuel/orders
cURLBash
curl "https://api.aeroselect.io/api/v1/aeroops/fuel/orders?airport=FRA&status=pending" \
  -H "X-API-Key: ak_live_YOUR_KEY"
Response 200JSON
{
  "data": [
    {
      "id": 701,
      "airport": "FRA",
      "aircraft_id": "D-AIMK",
      "flight_number": "LH1234",
      "amount_kg": 18500,
      "fuel_type": "jet_a1",
      "scheduled_at": "2026-05-22T05:00:00Z",
      "actual_amount_kg": null,
      "cost_usd": null,
      "supplier": "Shell Aviation",
      "status": "confirmed"
    }
  ]
}

POST /fuel/orders — Create Order

POSThttps://api.aeroselect.io/api/v1/aeroops/fuel/orders
cURLBash
curl -X POST "https://api.aeroselect.io/api/v1/aeroops/fuel/orders" \
  -H "X-API-Key: ak_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "airport": "MUC",
    "aircraft_id": "D-AXYZ",
    "flight_number": "AE0815",
    "amount_kg": 12000,
    "fuel_type": "jet_a1",
    "scheduled_at": "2026-06-01T13:00:00Z",
    "supplier": "BP Aviation"
  }'

Python — Daily fuel cost report

fuel-report.pyPython
import requests
from datetime import date

today = date.today().isoformat()
response = requests.get(
    f"https://api.aeroselect.io/api/v1/aeroops/fuel/orders?date={today}&status=completed",
    headers={"X-API-Key": os.environ["AEROSELECT_API_KEY"]},
)
orders = response.json()["data"]

total_kg = sum(o["actual_amount_kg"] or 0 for o in orders)
total_usd = sum(o["cost_usd"] or 0 for o in orders)
print(f"Fueled today: " + str(round(total_kg)) + " kg / $" + str(round(total_usd, 2)) + " USD")