Lumo Flights API (1.1.0)

Download OpenAPI specification:Download

Lumo API Support: 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.

Authentication

ApiKeyAuth

An API key from lumo is required to authenticate. You can request an api key at https://www.thinklumo.com/api-key-request or ping us on the chat on the bottom right of your page to get a production key. You can get a free trial key at https://www.thinklumo.com/sign-up-for-a-free-sandbox-api-key. Place the key into the HTTP request header as Token: <key> for the production API or x-api-key: <key> for the sandbox API.

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:

ApiKeyAuth

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

Response samples

Content type

application/json

{"flight": {"id": "UA576BOSSFO1606092145",
"uuid": "97f584b3-4a4c-4ac4-9787-225912f9d9cb",
"number": 576,
"operating_carrier": {"iata": "UA"
},
"carrier": {"iata": "UA",
"name": "United Airlines",
"friendly_name": "United"
},
"aircraft_type": {"generic": "EMJ",
"generic_description": "Embraer 170/195",
"specific": "E75",
"specific_description": "Embraer 175"
},
"scheduled_departure": "2017-04-20T12:00:00-06:00",
"scheduled_arrival": "2017-04-20T13:40:00-07:00",
"origin": {"iata": "BOS",
"city": "Boston",
"name": "General Edward Lawrence Logan Intl"
},
"destination": {"iata": "BOS",
"city": "San Francisco",
"name": "San Francisco Intl"
}
},
"prediction": {"delay_index": 6,
"risk": "HIGH",
"distribution": [0.2,
0.35,
0.35,
0.1
],
"causes": ["flight-cancelled"
],
"is_override": false
},
"status": {"text": "Scheduled",
"departure": {"scheduled": "2017-04-20T12:00:00-06:00",
"latest": "2017-04-20T12:00:00-06:00",
"type": "estimated",
"terminal": "A",
"gate": "A39"
},
"arrival": {"scheduled": "2017-04-20T13:40:00-07:00",
"latest": "2017-04-20T13:36:00-07:00",
"type": "estimated",
"terminal": "2",
"gate": "50B",
"baggage_claim": "12"
},
"diversion": {"airport": "ORD"
},
"cancelled": false,
"source": "flightview",
"last_updated": "2017-04-20T16:15:00Z"
},
"historical_performance": {"arrival_delay": [-19,
10002,
10002,
8,
4,
21,
21,
-8,
2,
8,
-15,
-5,
-16,
-14,
3,
10,
29,
77,
57,
-22,
-3,
-10,
-23,
-19,
-27,
-20,
17,
-15,
-13,
-10,
46,
78,
16,
72,
10002,
-4,
5,
-8,
-18,
-27,
8,
-8,
-2,
48,
-10,
-14,
2,
37,
171,
31,
10000,
23,
-4,
77,
45,
-8,
-14,
-9,
22,
73
],
"last_updated": "2017-04-18T18:00:00Z"
},
"weather": {"origin": {"icon": "partly-cloudy-day",
"summary": "Partly Cloudy",
"temperature": 67.36,
"precipitation": 0,
"hourly": true
},
"destination": {"icon": "partly-cloudy-day",
"summary": "Partly Cloudy",
"temperature": 67.36,
"precipitation": 0,
"hourly": true
}
},
"inbound": { },
"special_alerts": [{"id": 123,
"location": {"countries": ["US",
"CA"
],
"airports": ["BOS",
"LGA"
]
},
"airline": {"carrier_codes": ["AA"
]
},
"period": {"start": "2020-01-29T06:00:00",
"end": "2020-01-30T06:00:00",
"tz": "local"
},
"operation": {"arrivals": true,
"departures": false
},
"override_probs": false,
"alert": {"type": "waiver",
"summary": "United has issued travel waivers for Dec 11.",
"description": "United has issued travel waivers for flights on Dec 11 due to forecast weather conditions.",
"url": "https://www.thinklumo.com."
},
"send_alerts": "none",
"date_restrictions": {"ticket_issued_on_before": "2020-01-29",
"new_travel_begin": "2020-01-29",
"new_travel_end": "2020-01-29"
},
"dom_intl": "D",
"remarks": "This waiver applies only to DL codeshares with AF but not KL",
"waiver_codes": [{"waiver_code": "ABC12345",
"description": "cabin_to_cabin"
}
]
}
],
"travel_advisories": {"origin": [{"issued_by": "Government of Canada",
"advisory": "Chile - Avoid non-essential travel",
"scope": "country",
"url": "http://travel.state.gov/content/travel/en/traveladvisories/traveladvisories/chile-travel-advisory.html",
"last_updated": "2020-01-29T06:00:00Z"
}
],
"destination": [{"issued_by": "Government of Canada",
"advisory": "Chile - Avoid non-essential travel",
"scope": "country",
"url": "http://travel.state.gov/content/travel/en/traveladvisories/traveladvisories/chile-travel-advisory.html",
"last_updated": "2020-01-29T06:00:00Z"
}
]
},
"covid_stats": {"origin": {"country": {"daily_data": {"report_date": [