Skip to content
/
Get webhook subscription...

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

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

Create a new webhook subscription

Request

Create a new webhook subscription for receiving near real-time event notifications.

Features:

  • Validates callback URL format, only https is supported
  • Sets automatic expiration date (1 month) for subscriptions

Example Use Case: An operations manager needs to receive near real-time notifications when flight times change. By creating a webhook subscription for FLIGHT_TIME_UPDATE events, they can automatically sync flight data with external systems.

Security
X-Api-Client-Id and X-Auth-Token
Bodyapplication/jsonrequired
eventstring(WebhookEventType)required

The type of event that triggers the webhook notification. Each event type corresponds to specific flight-related changes or operations.

Enum"FLIGHT_CREATE""FLIGHT_CANCEL""FLIGHT_TIME_UPDATE""FLIGHT_AIRCRAFT_UPDATE""FLIGHT_AIRPORT_UPDATE""FLIGHT_POST_FLIGHT_STATUS""FLIGHT_MOVEMENT_UPDATE""FLIGHT_PAX_COUNT_UPDATE""FLIGHT_PAX_LIST_UPDATE"
callbackUrlstring(uri)required

The URL where webhook notifications will be sent. Must be a valid HTTPS URL.

Example: "https://example.com/webhooks/flight-updates"
signingKeystringrequired

A secret key used to verify webhook authenticity. This key will be used to sign webhook payloads.

Example: "your-secret-signing-key-123"
curl -i -X POST \
  https://test.fl3xx.com/api/v2/webhooks/subscriptions \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Client-Id: YOUR_API_KEY_HERE' \
  -H 'X-Auth-Token: YOUR_API_KEY_HERE' \
  -d '{
    "event": "FLIGHT_CREATE",
    "callbackUrl": "https://example.com/webhooks/flight-updates",
    "signingKey": "your-secret-signing-key-123"
  }'

Responses

Successfully created webhook subscription

Bodyapplication/json
idstring

Unique identifier for the webhook subscription.

Example: "webhook-sub-12345"
eventstring

The event type that this subscription is listening for.

Example: "FLIGHT_UPDATE"
callbackUrlstring(uri)

The URL where webhook notifications will be sent.

Example: "https://example.com/webhooks"
statusstring(DbStatusType)

Status of the webhook subscription indicating whether it is active and receiving notifications or inactive.

Enum"ACTIVE""INACTIVE"
createdAtDateTimestring(date-time)

The date and time when the webhook subscription was created.

Example: "2024-01-15T10:30:00.000Z"
updatedAtDateTimestring(date-time)

The date and time when the webhook subscription was last updated.

Example: "2024-01-15T10:30:00.000Z"
expirationDateTimestring(date-time)

The date and time when the webhook subscription will expire.

Example: "2024-02-15T10:30:00.000Z"
Response
application/json
{
  "id": "webhook-sub-12345",
  "event": "FLIGHT_UPDATE",
  "callbackUrl": "https://example.com/webhooks",
  "status": "ACTIVE",
  "createdAtDateTime": "2024-01-15T10:30:00.000Z",
  "updatedAtDateTime": "2024-01-15T10:30:00.000Z",
  "expirationDateTime": "2024-02-15T10:30:00.000Z"
}

Get webhook subscription by ID

Request

Retrieve a specific webhook subscription by its unique identifier.

Features:

  • Returns detailed subscription information
Security
X-Api-Client-Id and X-Auth-Token
Path
subscriptionIdstringrequired

The unique identifier of the webhook subscription to retrieve.

Example: webhook-sub-12345
curl -i -X GET \
  https://test.fl3xx.com/api/v2/webhooks/subscriptions/webhook-sub-12345 \
  -H 'X-Api-Client-Id: YOUR_API_KEY_HERE' \
  -H 'X-Auth-Token: YOUR_API_KEY_HERE'

Responses

Successfully retrieved webhook subscription

Bodyapplication/json
idstring

Unique identifier for the webhook subscription.

Example: "webhook-sub-12345"
eventstring

The event type that this subscription is listening for.

Example: "FLIGHT_UPDATE"
callbackUrlstring(uri)

The URL where webhook notifications will be sent.

Example: "https://example.com/webhooks"
statusstring(DbStatusType)

Status of the webhook subscription indicating whether it is active and receiving notifications or inactive.

Enum"ACTIVE""INACTIVE"
createdAtDateTimestring(date-time)

The date and time when the webhook subscription was created.

Example: "2024-01-15T10:30:00.000Z"
updatedAtDateTimestring(date-time)

The date and time when the webhook subscription was last updated.

Example: "2024-01-15T10:30:00.000Z"
expirationDateTimestring(date-time)

The date and time when the webhook subscription will expire.

Example: "2024-02-15T10:30:00.000Z"
Response
application/json
{
  "id": "webhook-sub-12345",
  "event": "FLIGHT_UPDATE",
  "callbackUrl": "https://example.com/webhooks",
  "status": "ACTIVE",
  "createdAtDateTime": "2024-01-15T10:30:00.000Z",
  "updatedAtDateTime": "2024-01-15T10:30:00.000Z",
  "expirationDateTime": "2024-02-15T10:30:00.000Z"
}

Update webhook subscription callback URL or status

Request

Update the callback URL for an existing webhook subscription.

Features:

  • Validates new callback URL format, only https is supported
  • Updates subscription status to active or inactive

Example Use Case: An operations manager needs to change the webhook endpoint URL after migrating to a new server. Using this endpoint, they can update the callback URL without recreating the entire subscription.

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

The unique identifier of the webhook subscription to update.

Example: webhook-sub-12345
Bodyapplication/jsonrequired
callbackUrlstring(uri)

The new URL where webhook notifications will be sent. Must be a valid HTTPS URL.

Example: "https://new-example.com/webhooks"
statusstring(DbStatusType)

Status of the webhook subscription indicating whether it is active and receiving notifications or inactive.

Enum"ACTIVE""INACTIVE"
curl -i -X PATCH \
  https://test.fl3xx.com/api/v2/webhooks/subscriptions/webhook-sub-12345 \
  -H 'Content-Type: application/json' \
  -H 'X-Api-Client-Id: YOUR_API_KEY_HERE' \
  -H 'X-Auth-Token: YOUR_API_KEY_HERE' \
  -d '{
    "callbackUrl": "https://new-example.com/webhooks",
    "status": "ACTIVE"
  }'

Responses

Successfully updated webhook subscription

Bodyapplication/json
idstring

Unique identifier for the webhook subscription.

Example: "webhook-sub-12345"
eventstring

The event type that this subscription is listening for.

Example: "FLIGHT_UPDATE"
callbackUrlstring(uri)

The URL where webhook notifications will be sent.

Example: "https://example.com/webhooks"
statusstring(DbStatusType)

Status of the webhook subscription indicating whether it is active and receiving notifications or inactive.

Enum"ACTIVE""INACTIVE"
createdAtDateTimestring(date-time)

The date and time when the webhook subscription was created.

Example: "2024-01-15T10:30:00.000Z"
updatedAtDateTimestring(date-time)

The date and time when the webhook subscription was last updated.

Example: "2024-01-15T10:30:00.000Z"
expirationDateTimestring(date-time)

The date and time when the webhook subscription will expire.

Example: "2024-02-15T10:30:00.000Z"
Response
application/json
{
  "id": "webhook-sub-12345",
  "event": "FLIGHT_UPDATE",
  "callbackUrl": "https://example.com/webhooks",
  "status": "ACTIVE",
  "createdAtDateTime": "2024-01-15T10:30:00.000Z",
  "updatedAtDateTime": "2024-01-15T10:30:00.000Z",
  "expirationDateTime": "2024-02-15T10:30:00.000Z"
}