Lumo Flights API (1.1.0)

Download OpenAPI specification:Download

Lumo API Support: api-support@thinklumo.com License: Apache 2.0

Lumo's API provides realtime and predictive flight status (Lumo's delay predictions) for flights worldwide.

The API has three modules:

  • status API - allows consumers to obtain flight data for specific flights or for flights based on search criteria. Also provides Lumo's curated suggestion of alternative flights in the case that a flight is predicted to be delayed.
  • subscription - this webhooks api allows clients to subscribe to specific itineraries and provide a callback URL. Whenever there are changes to any flights on that itinerary, they will receive an update at that callback URL.
  • manage - this set of endpoints allows clients to update travelers and itineraries for a Lumo Navigator organization.

We provide a 30-day free trial of our API with a rate limit of 100 requests per minute and 10,000 requests per month.

Note: We're slowly migrating our documentation from GitHub so please check out https://github.com/thinklumo/api-docs if you can't find what you're looking for.

Authentication

ApiKeyAuth

An API key from lumo is required to authenticate. Please contact api-support@thinklumo.com or ping us on Intercom. Place the key into the HTTP request header as Token: <key>.

Security scheme type: API Key
header parameter name: Token

flights

Allows consumers to obtain flight data for specific flights or for flights based on search criteria. Also provides Lumo's curated suggestion of alternative flights in the case that a flight is predicted to be delayed.

Use the server https://api.thinklumo.com/flights/v1 for these endpoints.

Retrieve predicted and realtime status for a flight

This endpoint retrieves information for a single flight, specified by flight ID. In addition to prediction and realtime status data, which are retrieved by default, historical performance, weather, and inbound flight information is also available by specifying the appropriate query parameters.

To retrieve a single flight without constructing the flight id, use the /status endpoint below.

Authorizations:
path Parameters
flight_id
required
string (LumoFlightId)
Example: "UA576BOSSFO1606092145"

The LumoFlightId for the flight, which can be constructed as: [IATA carrier code][flight number][departure airport][arrival airport][scheduled departure time as YYMMDDHHMM in UTC time]

query Parameters
inbound
boolean
Default: false

include inbound inbound flight status

weather
boolean
Default: false

include weather data

history
boolean
Default: false

include historical delay data

round
boolean
Default: true

round the delay distribution. We recommend using the rounded distribution to better communicate delay to end users.

Responses

200

OK

401

API key is missing or invalid

404

The most common cause of 404s is that the flight ID specified is not of the correct format, or has expired (flight has already landed).

get /flights/v1/status/{flight_id}

Lumo API

https://api.thinklumo.com/flights/v1/status/{flight_id}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "flight":
    {
    },
  • "prediction":
    {
    },
  • "status":
    {
    },
  • "historical_performance":
    {
    },
  • "weather":
    {
    },
  • "inbound": { }
}

Retrieve predicted and realtime status for a flight, specified by airline, flight number, and departure date.

This endpoint retrieves information for a single flight without having to specify the flight ID. In addition to prediction and realtime status data, which are retrieved by default, historical performance, weather, and inbound flight information is also available by specifying the appropriate query parameters.

The flight is uniquely specified using the required query parameters airline, flight_number, and date. In the case that these three do not uniquely specify a flight, origin and/or destination must also be used.

To retrieve all flights matching a set of criteria, use the /search endpoint instead, which filters on the same query parameters.

Authorizations:
query Parameters
carrier
string (IataCarrierCode)
Example: "AA"

IATA carrier code

flight_number
number
Example: 12

flight number

date
string <date>
Example: "2018-10-08"

Departure date in local time

origin
string (IataAirportCode)
Example: "BOS"

origin airport code

destination
string (IataAirportCode)
Example: "BOS"

destination airport code

inbound
string (IataAirportCode)
Example: "BOS"

include inbound flight status

weather
boolean
Default: false

include weather data

history
boolean
Default: false

include historical delay data

round
boolean
Default: true

round the delay distribution. We recommend using the rounded distribution to better communicate delay to end users.

Responses

200

OK

400

Flight is not uniquely specified. This occurs when the required query parameters (carrier, flight number, date) together with the optional parameters (origin, destination) do not specify a unique flight.

401

API key is missing or invalid

404

The most common cause of 404s is that the flight ID specified is not of the correct format, or has expired (flight has already landed).

get /flights/v1/status

Lumo API

https://api.thinklumo.com/flights/v1/status

Response samples

application/json
Copy
Expand all Collapse all
[
  • {
    }
]

Retrieve a curated list of alternative flights when a specific flight is predicted to be delayed.

Authorizations:
path Parameters
flight_id
required
string (LumoFlightId)
Example: "WN55DALHOU1608300100"

Retrieves alternates flights for the specified flight, sorted by increasing departure time. When the delay index is under 5, no alternates are available.

Responses

200

OK

401

API key is missing or invalid

404

The most common cause of 404s is that the flight ID specified is not of the correct format, or has expired (flight has already landed).

get /flights/v1/alternates/{flight_id}

Lumo API

https://api.thinklumo.com/flights/v1/alternates/{flight_id}

Response samples

application/json
Copy
Expand all Collapse all
{
  • "count": 6,
  • "flights":
    [