Skip to content

⛽ Publishing Airport Fuel Prices

Send your fuel prices per airport through the FL3XX API and put them in front of the operator's dispatchers, right where they plan the flight

1
⛽

Send Prices

2
👀

Where They Appear

3
🔄

Maintain Prices

4
🚫

Limits

Fuel suppliers and fuel price providers can publish their prices to an FL3XX operator airport by airport. Every price you send lands on that airport in the operator's FL3XX environment, and from there it is pulled into the flights in Dispatch, so the dispatcher sees your offer while choosing a fuel supplier for the leg.

All examples use the test server https://test.fl3xx.com. Every request is bound to the operator linked to your token, so the prices you send are only visible to that operator. For full request and response schemas, see the API Reference.

💡Common Use Case: A Daily Price Feed

Once a day, or whenever your prices change, send one request per airport with the full set of offers you hold there. Each request replaces what you sent for that airport before, so the operator always sees your current list, with no stale tiers left behind.

⛽

Send Prices

Publish the prices for one airport

The Endpoint

PUT/api/v2/partners/airports/{airportCode}/fuel-prices

Set the fuel prices for one airport.

airportCode accepts an ICAO, IATA or FAA code, or the FL3XX airport id. Authenticate with the X-Api-Client-Id and X-Auth-Token headers.

The Request Body

The body is an array of price entries. Each entry describes one offer: one FBO, one contractor and one volume tier.

fboNameRequiredName of the FBO at the airport
contractorNameRequiredName of the contractor providing the fuel
currencyRequiredEUR or USD
unitRequiredLITER or GALLON_USA
volumeFromRequiredLower bound of the tier, inclusive, zero or greater
volumeToRequiredUpper bound of the tier, inclusive, zero or greater
pricingPrivateOptionalPrivate pricing, with price and priceIndex
pricingCommercialOptionalCommercial pricing, with price and priceIndex
preArrivalRemarksOptionalPre arrival instructions for the fuel service
paymentMethodOptionalAccepted payment methods
phoneOptionalContact phone of the FBO or fuel provider
emailOptionalContact email of the FBO or fuel provider
remarksOptionalAny additional notes
expirationDateTimeOptionalWhen the offer expires, as yyyy-MM-ddTHH:mm:ss.SSSZ

Example Request

curl -X PUT "https://test.fl3xx.com/api/v2/partners/airports/LOWW/fuel-prices" \
  -H "X-Api-Client-Id: <your client id>" \
  -H "X-Auth-Token: <your token>" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "fboName": "Jet FBO",
      "contractorName": "Shell Aviation",
      "currency": "EUR",
      "unit": "LITER",
      "volumeFrom": 0,
      "volumeTo": 5000,
      "pricingPrivate": { "price": 1.85, "priceIndex": 105.5 },
      "pricingCommercial": { "price": 1.65, "priceIndex": 98.0 },
      "preArrivalRemarks": "24 hour notice required",
      "paymentMethod": "Credit Card, Invoice",
      "remarks": "Preferred fuel provider",
      "expirationDateTime": "2026-12-31T23:59:59.000Z"
    }
  ]'

A successful call returns 200 with the stored entries, each now carrying its own id, the airport, the source and the created and updated timestamps. Keep the id if you want to change or remove a single entry later.

👀

Where They Appear

Airports and Dispatch in FL3XX

🔄

Maintain Prices

Read, update and delete what you sent

🚫

Limits

Rules every request has to follow

📖View API Reference📧Contact Support