Fuel Management
Plan fueling orders, manage them and track costs.
Fuel Order Object
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
| id | integer | Optional | Unique order ID |
| airport | string | Pflicht | Airport (IATA)z.B. FRA |
| aircraft_id | string | Pflicht | Aircraft registrationz.B. D-AIMK |
| flight_number | string | Optional | Associated flight numberz.B. LH1234 |
| amount_kg | number | Pflicht | Requested fuel quantity in kilograms |
| fuel_type | enum | Pflicht | jet_a1 | avgas | sustainable_aviation_fuel |
| scheduled_at | datetime | Pflicht | Scheduled fueling time (UTC, ISO 8601) |
| actual_amount_kg | number|null | Optional | Actual quantity fueled (after fueling) |
| cost_usd | number|null | Optional | Cost in USD |
| supplier | string|null | Optional | Fuel supplierz.B. Shell Aviation |
| status | enum | Optional | pending | confirmed | completed | cancelled |
| created_at | datetime | Optional | Creation 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")