Skip to content

FL3XX API (2.0.0)

FL3XX API v2.0 - Beta Release

Currently in active development with our trusted beta partners. Experience the next generation of aviation API technology.

BETA
Download OpenAPI description
index.json
index.yaml
Overview
URL

https://www.fl3xx.com

FL3XX Integration Support

integrations@fl3xx.com

License

MIT

Languages
Servers
Test Server

https://test.fl3xx.com/

Airports

Access comprehensive airport information.

Business Value

  • Filter airports by various criteria including ICAO, IATA, FAA codes and local identifiers
  • Support high-performance applications with optimized data retrieval

Use Cases

  • Filter airports by specific codes for targeted data retrieval
  • Integrate airport data into flight planning and scheduling systems
  • Build airport selection interfaces with efficient pagination

Operations

Airport Fuel Prices

Manage and optimize airport fuel pricing data for your organization. These endpoints enable operators to efficiently update, remove, and bulk-manage fuel prices, supporting streamlined fuel order workflows and provider management.

Business Value

  • Ensure accurate and up-to-date fuel pricing for all airport operations.
  • Reduce manual effort and errors by enabling bulk updates and deletions.
  • Support cost control and negotiation with providers through transparent pricing data.
  • Enhance operational planning and financial forecasting with reliable fuel cost data.

Use Cases

  • Update fuel prices for a specific airport to reflect new agreements or market changes.

  • Remove outdated or incorrect fuel prices for compliance and data integrity.

  • Perform bulk deletions to quickly adapt to network-wide pricing changes.

  • Integrate with internal systems to automate fuel price management and reporting.


Note:

The data managed by the Airport Fuel Prices endpoints is strictly bound to the context of the operator associated with the calling authentication token. All operations—creating, updating, or deleting airport fuel prices—apply only to the operator for which the provided token is valid.

Operations

Get fuel prices for an airport

Request

Retrieve all fuel prices for a specific airport that were submitted by the partner associated with the authentication token.

Note: Only fuel prices associated with the operator linked to the authentication token will be returned.

Security
X-Api-Client-Id and X-Auth-Token
Path
airportCodestringrequired

The airport code for which fuel prices are being retrieved. This can be an IATA, ICAO, FAA code, or airport ID.
Valid examples during demo include: AGAT, AGGR, EBCR, EGSK, EHPC, EPJA, DAOS

Example: AGAT
curl -i -X GET \
  https://test.fl3xx.com/api/v2/partners/airports/AGAT/fuel-prices \
  -H 'X-Api-Client-Id: YOUR_API_KEY_HERE' \
  -H 'X-Auth-Token: YOUR_API_KEY_HERE'

Responses

Successfully retrieved fuel prices

Bodyapplication/jsonArray [
idstring

Unique identifier for the fuel price record

Example: "12345"
fboNamestring

Name of the Fixed Base Operator (FBO)

Example: "Jet FBO"
contractorNamestring

Name of the fuel contractor

Example: "Shell Aviation"
currencystring

Currency code for the fuel prices

Example: "EUR"
volumeFromnumber(double)

Minimum volume for this price tier

Example: 1000
volumeTonumber(double)

Maximum volume for this price tier

Example: 5000
unitstring(UnitVolume)

The unit of volume for the fuel prices. This indicates whether the prices are specified per liter or per US gallon. The options are:

  • LITER: Prices are specified per liter.
  • GALLON_USA: Prices are specified per US gallon.
Enum"LITER""GALLON_USA"
pricingPrivateobject(FuelPrice)
pricingCommercialobject(FuelPrice)
preArrivalRemarksstring

Remarks for pre-arrival fuel services

Example: "24-hour notice required"
paymentMethodstring

Accepted payment methods

Example: "Credit Card, Invoice"
phonestring

Contact phone number

Example: "+1-555-123-4567"
emailstring(email)

Contact email address

Example: "fuel@jetfbo.com"
remarksstring

Additional remarks or notes

Example: "Preferred fuel provider"
airportobject(AirportMinimalDto)
sourcestring

Source of the fuel price data

Example: "Partner API"
vendorIdstring

Vendor identifier

Example: "vendor123"
vendorNamestring

Vendor name

Example: "Fuel Provider Inc"
expirationDateTimestring(date-time)

Expiration date and time for the fuel price

Example: "2024-12-31T23:59:59.000Z"
createdAtDateTimestring(date-time)

Creation date and time

Example: "2024-12-31T23:59:59.000Z"
updatedAtDateTimestring(date-time)

Last update date and time

Example: "2024-12-31T23:59:59.000Z"
]
Response
application/json
[
  {
    "id": "12345",
    "fboName": "Jet FBO",
    "contractorName": "Shell Aviation",
    "currency": "EUR",
    "volumeFrom": 1000,
    "volumeTo": 5000,
    "unit": "LITER",
    "pricingPrivate": { … },
    "pricingCommercial": { … },
    "preArrivalRemarks": "24-hour notice required",
    "paymentMethod": "Credit Card, Invoice",
    "phone": "+1-555-123-4567",
    "email": "fuel@jetfbo.com",
    "remarks": "Preferred fuel provider",
    "airport": { … },
    "source": "Partner API",
    "vendorId": "vendor123",
    "vendorName": "Fuel Provider Inc",
    "expirationDateTime": "2024-12-31T23:59:59.000Z",
    "createdAtDateTime": "2024-12-31T23:59:59.000Z",
    "updatedAtDateTime": "2024-12-31T23:59:59.000Z"
  }
]

Update fuel prices for an airport

Request

Update or set fuel prices for a specific airport. This endpoint allows partners to submit fuel pricing information that will be used for operational and financial processes.

Note: Only fuel prices associated with the operator linked to the authentication token can be updated.

Example Use Case: An operations manager needs to update the fuel price for a particular airport after receiving new rates from a provider. By using this endpoint, they can ensure that all future fuel orders and cost calculations use the most current pricing data.

Security
X-Api-Client-Id and X-Auth-Token
Path
airportCodestringrequired

The airport code for which fuel prices are being updated. This can be an IATA, ICAO, FAA code, or airport ID.
Valid examples during demo include: AGAT, AGGR, EBCR, EGSK, EHPC, EPJA, DAOS

Example: AGGR
Bodyapplication/jsonrequiredArray [
fboNamestringrequired

The name of the Fixed Base Operator (FBO) at the airport. This is the entity responsible for providing fuel services.

Example: "Jet FBO"
contractorNamestringrequired

The name of the contractor providing the fuel services. This could be a fuel supplier or service provider.

Example: "Shell Aviation"
currencystring(Currency)required

The currency in which the fuel prices are specified. This is a three-letter ISO currency code, such as EUR for Euro or USD for US Dollar.

Enum"EUR""USD"
unitstring(UnitVolume)required

The unit of volume for the fuel prices. This indicates whether the prices are specified per liter or per US gallon. The options are:

  • LITER: Prices are specified per liter.
  • GALLON_USA: Prices are specified per US gallon.
Enum"LITER""GALLON_USA"
volumeFromnumber(double)>= 0

The minimum volume (inclusive) for which this fuel price applies. Used to define the lower bound of the applicable volume range.

Example: 1000
volumeTonumber(double)>= 0

The maximum volume (inclusive) for which this fuel price applies. Used to define the upper bound of the applicable volume range.

Example: 5000
pricingPrivateobject(FuelPrice)
pricingCommercialobject(FuelPrice)
preArrivalRemarksstring

Remarks or instructions for pre-arrival fuel services. This could include special handling instructions or requirements.

Example: "24-hour notice required"
paymentMethodstring

The method of payment for the fuel services. This could include options like credit card, invoice, or cash.

Example: "Credit Card, Invoice"
phonestring

The contact phone number for the FBO or fuel provider. This is used for communication regarding fuel services.

Example: "+1-555-123-4567"
emailstring(email)

The contact email address for the FBO or fuel provider. This is used for communication regarding fuel services.

Example: "fuel@jetfbo.com"
remarksstring

Additional remarks or comments regarding the fuel services. This could include special requests or notes for the fuel provider.

Example: "Preferred fuel provider"
expirationDateTimestring(date-time)

The expiration date and time for the fuel price offer. After this time, the offer may no longer be valid.

Example: "2024-12-31T23:59:59.000Z"
]
curl -i -X PUT \
  https://test.fl3xx.com/api/v2/partners/airports/AGGR/fuel-prices \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Client-Id: YOUR_API_KEY_HERE' \
  -H 'X-Auth-Token: YOUR_API_KEY_HERE' \
  -d '[
    {
      "fboName": "Jet FBO",
      "contractorName": "Shell Aviation",
      "currency": "EUR",
      "volumeFrom": 1000,
      "volumeTo": 5000,
      "unit": "LITER",
      "pricingPrivate": {
        "price": 1.85,
        "priceIndex": 105.5
      },
      "pricingCommercial": {
        "price": 1.85,
        "priceIndex": 105.5
      },
      "preArrivalRemarks": "24-hour notice required",
      "paymentMethod": "Credit Card, Invoice",
      "phone": "+1-555-123-4567",
      "email": "fuel@jetfbo.com",
      "remarks": "Preferred fuel provider",
      "expirationDateTime": "2024-12-31T23:59:59.000Z"
    }
  ]'

Responses

Successfully updated fuel prices

Bodyapplication/jsonArray [
idstring

Unique identifier for the fuel price record

Example: "12345"
fboNamestring

Name of the Fixed Base Operator (FBO)

Example: "Jet FBO"
contractorNamestring

Name of the fuel contractor

Example: "Shell Aviation"
currencystring

Currency code for the fuel prices

Example: "EUR"
volumeFromnumber(double)

Minimum volume for this price tier

Example: 1000
volumeTonumber(double)

Maximum volume for this price tier

Example: 5000
unitstring(UnitVolume)

The unit of volume for the fuel prices. This indicates whether the prices are specified per liter or per US gallon. The options are:

  • LITER: Prices are specified per liter.
  • GALLON_USA: Prices are specified per US gallon.
Enum"LITER""GALLON_USA"
pricingPrivateobject(FuelPrice)
pricingCommercialobject(FuelPrice)
preArrivalRemarksstring

Remarks for pre-arrival fuel services

Example: "24-hour notice required"
paymentMethodstring

Accepted payment methods

Example: "Credit Card, Invoice"
phonestring

Contact phone number

Example: "+1-555-123-4567"
emailstring(email)

Contact email address

Example: "fuel@jetfbo.com"
remarksstring

Additional remarks or notes

Example: "Preferred fuel provider"
airportobject(AirportMinimalDto)
sourcestring

Source of the fuel price data

Example: "Partner API"
vendorIdstring

Vendor identifier

Example: "vendor123"
vendorNamestring

Vendor name

Example: "Fuel Provider Inc"
expirationDateTimestring(date-time)

Expiration date and time for the fuel price

Example: "2024-12-31T23:59:59.000Z"
createdAtDateTimestring(date-time)

Creation date and time

Example: "2024-12-31T23:59:59.000Z"
updatedAtDateTimestring(date-time)

Last update date and time

Example: "2024-12-31T23:59:59.000Z"
]
Response
application/json
[
  {
    "id": "12345",
    "fboName": "Jet FBO",
    "contractorName": "Shell Aviation",
    "currency": "EUR",
    "volumeFrom": 1000,
    "volumeTo": 5000,
    "unit": "LITER",
    "pricingPrivate": { … },
    "pricingCommercial": { … },
    "preArrivalRemarks": "24-hour notice required",
    "paymentMethod": "Credit Card, Invoice",
    "phone": "+1-555-123-4567",
    "email": "fuel@jetfbo.com",
    "remarks": "Preferred fuel provider",
    "airport": { … },
    "source": "Partner API",
    "vendorId": "vendor123",
    "vendorName": "Fuel Provider Inc",
    "expirationDateTime": "2024-12-31T23:59:59.000Z",
    "createdAtDateTime": "2024-12-31T23:59:59.000Z",
    "updatedAtDateTime": "2024-12-31T23:59:59.000Z"
  }
]

Delete all fuel prices for an airport

Request

Delete all fuel prices for a specific airport that were submitted by the partner associated with the authentication token.

Note: Only fuel prices associated with the operator linked to the authentication token can be deleted.

Example Use Case: An operations manager needs to remove all fuel prices for an airport after a provider contract ends or when prices are no longer valid. Using this endpoint ensures that no obsolete pricing data is used in future fuel orders or cost calculations.

Security
X-Api-Client-Id and X-Auth-Token
Path
airportCodestringrequired

The airport code for which fuel prices are being deleted. This can be an IATA, ICAO, FAA code, or airport ID.
Valid examples during demo include: AGAT, AGGR, EBCR, EGSK, EHPC, EPJA, DAOS

Example: AGGR
curl -i -X DELETE \
  https://test.fl3xx.com/api/v2/partners/airports/AGGR/fuel-prices \
  -H 'X-Api-Client-Id: YOUR_API_KEY_HERE' \
  -H 'X-Auth-Token: YOUR_API_KEY_HERE'

Responses

Successfully deleted fuel prices

Webhooks

Manage webhook subscriptions for near real-time event notifications. These endpoints enable partners to create, manage, and monitor webhook subscriptions for receiving flight-related events and updates.

Business Value

  • Receive near real-time notifications for flight events and updates.
  • Automate integration workflows with external systems.
  • Monitor flight operations and passenger changes in near real-time.
  • Reduce polling overhead by using event-driven architecture.

Use Cases

  • Subscribe to flight updates to sync data with external booking systems.
  • Monitor passenger count changes for catering and ground service coordination.
  • Track aircraft changes for maintenance and operational planning.
  • Receive notifications for flight cancellations and time updates.

Available Event Types:

  • FLIGHT_CREATE: New flight creation
  • FLIGHT_CANCEL: Flight cancellation
  • FLIGHT_TIME_UPDATE: Flight time changes
  • FLIGHT_AIRCRAFT_UPDATE: Aircraft assignment changes
  • FLIGHT_AIRPORT_UPDATE: Airport(s) changes
  • FLIGHT_POST_FLIGHT_STATUS: Post-flight status updates
  • FLIGHT_MOVEMENT_UPDATE: Flight movement updates
  • FLIGHT_PAX_COUNT_UPDATE: Passenger count changes
  • FLIGHT_PAX_LIST_UPDATE: Passenger list changes (e.g. new passengers, updated list, passenger document changes, etc.)
Operations