Historical Flight Delay API — Historical Flight Delay and Cancellation Data
Tags: flightdata, developers, flightapi, airportapi
Published: 2022-08-14 10:34:10


Aviation Edge [Historical Flight Delay API](https://aviation-edge.com/flight-delay-api/) provides historical flight delay data and flight cancellation data for flight compensation agencies, market analysis, independent developers, aviation companies, and more.

Flight compensation demand makes **delay and cancellation data** an important asset. We aggregate, store, and maintain **flight delay and cancellation data** in an expanding manner. In this article, we will give you the highlights on how Aviation Edge Historical Flight Delay API can be a useful external data source to track and process historical flight delay data, what sort of details it offers, and how to access the API.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/4g4bluvhlsb3aaif20th.jpeg)


The Historical Flight Delay API returns a flight-by-flight output of airport schedules **based on a requested date or date range in the past**.  The date range can go up to 7 days. The Historical Flight Delay API is a **JSON REST API** that has worldwide coverage except for non-scheduled airports like military airfields. However, for multi-purpose airports (i.e. scheduled passenger + military), the schedule data would still be available.

> Two notable points for flight compensation projects:

> 
- Delay data is available for all flights in the response. The value is the **total delay length in minutes**. If no delay occurred, the value will be "null".
> 
- The Historical Flight Delay API shows the _final_ flight status (including “canceled” as a status) and it is possible to **filter flights by status**. So you can view all canceled flights on a specific date or date range in the past for an airport.
> 
- The API can return **either the departure or the arrival schedule** at a time, so in case you'd like to cover both schedules for an airport, you may simply make 2 separate API calls.

Read below for more information on the parameters!

-------

## Flight Delay API Filters

We have enabled certain parameters that filter down the exact flights you are looking for in the output. You can use the following parameters with the Flight Delay API:

- **&code= (obligatory)** IATA code of the airport
- **&type= (obligatory)** schedule type that can be either “departure” or “arrival”
- **&date_from= (obligatory)** requested start date. For single dates, this is sufficient without an end date.
- **&date_to=** requested end date. No need to use it for single dates.
- **&dep_iataCode=** flights scheduled to depart at Airport X if you have requested an arrival schedule
- **&arr_iataCode=** flights scheduled to arrive at Airport X if you have requested a departure schedule
- **&airline_iata=** airline IATA code
- **&flight_num=** flight number in “1234” format (use it with the airline filter for full flight number filtering)
- **&status=** last recorded flight status (landed, active, cancelled, etc.)
The first 3 parameters are obligatory. You can then use the remaining ones to filter the flights further.


![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/f4nu1dd5nkk4yhqtok2y.png)

> **Tip:** Visit the documentation on the [Aviation Edge Website](https://aviation-edge.com/developers/) or the GitHub repo of the API for full input, output, filter information, and more.
{% embed https://github.com/AviationEdgeAPI/Historical-Schedules-API %}

--------

## Use-cases of the Historical Schedules API
The Historical Schedules API is particularly useful for the **flight compensation** field but there is no limit to who can make use of it. Businesses of every size and any developer who is interested in historical airport schedule data will find good use in the Historical Schedules API and build powerful projects implementing it.

#### Example Use Cases:

- Historical flight delays and cancellation analyses for flight compensation
- Websites, tools, or mobile iOS and Android apps on historical flight status and routes
- Viewing changes in airport or airline traffic over time
- Average delay and cancellation market analysis for airlines and airports
- Academic or non-profit research _(Tip: Holler us if you are working for a non-profit or looking to use the data for academic projects and we can talk about a free key or discount opportunity!)_

--------

## Flight Delay Data — Accuracy, Sources, Speed
Is the data accurate? Where do we get the data? What are the response rates like? I want to build an app or a website that runs smoothly!

Let’s explain these.

Aviation Edge Historical Flight Schedules API is trusted by multiple major airlines, ground operations, government bodies, software companies, consultancy companies, compensation claim and travel agencies of all sizes, independent developers, academics, non-profits, and aviation enthusiasts. We expand the historical airport schedule database by **storing** real-time data which we provide through our trusted data partners in the sector and official sources (from airlines or airports, or official bodies like IATA when available).

We have an **average uptime of 99.8% with response rates at around 0.3 ms**. This, of course, may depend on the data volume requested in one API call, just like with any other API. The API is subject to a notable [**Service Level Agreement**](https://aviation-edge.com/service-level-agreement/) with guarantees.

---------

## How To Access the Flight Delay API
You can create an API subscription with one of the **Premium API** options below and your API key will be sent to your email address automatically. Get started with **greatly discounted rates**.
{% embed https://aviation-edge.com/premium-api/ %}

-------

You can downgrade, upgrade or cancel your plan anytime **without commitments**. You can send us an email if you have any questions along the way and we will get back to you shortly.

![Image description](https://dev-to-uploads.s3.amazonaws.com/uploads/articles/3wzsoe9ierfnd9mf51bz.png)

Got any questions? [**Contact us**](https://aviation-edge.com/contact/) anytime!

----------

Follow us everywhere!
{% embed https://linktr.ee/AviationEdgeAPI %}