Historical Flight Schedules API with Cancellation and Delay Data

Flight status might be the most important and the most widely used type of data among aviation data. This is mostly due it’s field of usage. Keeping passengers up-to-date about their flight status is one of the key aspects of hospitality and compensation claim services.

This means that the data in order to develop apps to support these services requires data in both ways: historical and real-time.

Luckily, Aviation Edge has both but we will be focusing on Historical Flight Schedules API in this article.

Keep reading to have a better idea about the APIs and reach useful links to get started right away!

We’ve all heard of passengers becoming eligible for a compensation up to 600 Euros in case of a cancelled flight. This passenger-friendly right is currently applicable for EU/UK flights. The applicable regulation, in short, regulates passenger rights in case of denied boarding and cancellation or long delay of flights. As a result, businesses in claim support field are in need of accurate cancellation and delay data that spreads to a wide span of timeline. This way, they are successfully able to offer their customers a correct approach for their claims of a flight compensation.


Where to get flight cancellation and delay data?

All this brings the question “Where can I get historical cancellation and delay data” to developers’ minds. If you are one, a fully aggregated historical airport schedule data including delays and cancellations might be all you need. We’ve built our Historical Flight Schedules API in a way that is very easy to use with the most efficient data structure. The uptimes are of the highest ones in the market while the data is reliable with many filters to help you get exactly what you are looking for.


An example for a standard response is as follows:
{
"type":"arrival",
"status":"cancelled",
"departure":{"iata_code":"MLA",
"icao_code":"LMML",
"scheduled_time":"2020-07-18T08:35:00.000"},
"arrival":
{"iata_code":"LGW",
"icao_code":"EGKK",
"terminal":"S",
"scheduled_time":"2020-07-18T10:55:00.000"},
"airline":
{"name":"Air Baltic",
"iata_code":"BT",
"icao_code":"BTI"},
"flight":
{"number":"6079",
"iata_number":"BT6079",
"icao_number":"BTI6079"},
"codeshared":
{"airline":
{"name":"Air Malta",
"iata_code":"KM",
"icao_code":"AMC"},
"flight":
{"number":"116",
"iata_number":"KM116",
"icao_number":"AMC116"}
}
}
,

Endpoint used:

GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=LGW&type=arrival&date_from=2020-07-18&flight_number=[6079]

You may use the following endpoint for all cancelled flights of this schedule:

GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=LGW&type=arrival&date_from=YYYY-MM-DD&status=cancelled

{
"type":"arrival",
"status":"landed",
"departure":
{"iata_code":"IST",
"icao_code":"LTFM",
"gate":"A11A",
"delay":20,
"scheduled_time":"2020-07-18T07:10:00.000",
"estimated_time":"2020-07-18T07:10:00.000",
"actual_time":"2020-07-18T07:30:00.000",
"estimated_runway":"2020-07-18T07:30:00.000",
"actual_runway":"2020-07-18T07:30:00.000"},
"arrival":
{"iata_code":"LGW",
"icao_code":"EGKK",
"terminal":"N",
"scheduled_time":"2020-07-18T09:20:00.000",
"estimated_time":"2020-07-18T08:48:00.000",
"actual_time":"2020-07-18T08:48:00.000",
"estimated_runway":"2020-07-18T08:48:00.000",
"actual_runway":"2020-07-18T08:48:00.000"},
"airline":
{"name":"Turkish Airlines",
"iata_code":"TK",
"icao_code":"THY"},
"flight":
{"number":"1981",
"iata_number":"TK1981",
"icao_number":"THY1981"
}
}

Endpoint used:

GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=LGW&type=arrival&date_from=2020-07-18&flight_number=[1981]

For all delayed flights of this schedule, you may retrieve the whole schedule and filter on your end.

GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=LGW&type=arrival&date_from=YYYY-MM-DD


Filter the Data with Historical Airport Schedules API

The API filters are very suitable especially for flight compensation claim businesses. It allows filtering based on a specific status which can be cancelled or delayed among many others. The Historical Airport Schedules API also allows pulling data based on a specific date or a date range in the past, making sure you receive all you need in a single API call. For delayed flights, not only the status but also the delay amount by minute is available. It is possible to filter for a specific airline or a flight as well. All for our clients’ convenience.

Filters and endpoints available for the Historical Airport Schedules API in examples:

For the departure timetable of a certain airport on a certain date.
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=departure&date_from=YYYY-MM-DD

For the arrival timetable of a certain airport on a certain date.
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=arrival&date_from=YYYY-MM-DD

For the timetable of a certain airport of a certain date range (also available for arrival).
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=departure&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD

For the timetable of a certain airport on a certain date (or range) but only flights with a certain status.
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=arrival&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD&status=cancelled

For tracking individual historical flights.
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=departure&date_from=YYYY-MM-DD&date_to=YYYY-MM-DD&flight_number=[1234]

For filtering the flights of a certain airline from the arrival timetable of a certain airport on a certain date (also available for departure timetable and as a date range).
GET http://aviation-edge.com/v2/public/flightsHistory?key=[API_KEY]&code=JFK&type=arrival&date_from=YYYY-MM-DD&&airline_iata=TK


Available API Filters:

  • &type=departure or arrival
  • &date_from=YYYY-MM-DD
  • &date_to=YYYY-MM-DD
  • &iata_code=JFK
  • &status=landed, cancelled, unknown,
  • &airline_iata=U2
  • &flight_number=8670

Status can be: (landed, cancelled, unknown)

Delay amount is included in minutes if a flight was delayed at the date.

The maximum date range can be 30 days.

The historical data starts from May 2020.



Start getting fast and reliable airport schedule data including delays and cancellations with your personal API key!

Get your API within seconds and start developing your project right away. Your API will not only grant you access to the Historical Schedules API but also many other static and passive APIs that you can freely use. These include real-time Airport Schedules API, Flight Tracker API as well as many passive APIs like Countries, Airline Routes, Cities, Timezones and many more, also available in standalone database form in SQL, Excel and CSV formats.

Click on the buttons on the right to get started or contact us if you need more information. Our team is happy to get back to you asap!

TEST THE DATA!

Get your personal API key with prices starting at $5 only or check out our standalone databases:

Close Menu