DEV Community

Aviyair
Aviyair

Posted on

Historical Airport Schedules API – Returns Just What It Promises!

Stumbling upon this article, a historical airport schedules API is probably the data tool you’ve been looking for to get started with your project. Aviyair’s API promises this exact data for airports all around the world with just the necessary objects with each request. Let’s break down what you can expect with the API. If you don’t have time to go through this article, you can find a link to the full documentation and how to get your API key at the bottom.

Image description


Table of Contents

  1. API Structure and Integration Environment
  2. Example 200 OK Output and Full Documentation
  3. URL Examples with API Methods and Filters
  4. Summary and API Key Link

API Structure and Integration Environment

The structure of the Historical Airport Schedules API is REST which means your preferred programming language will be supported when integrating. REST’s highly adapted style is a developer-friendly feature that will ease the integration phase. In Aviyair, our team members include developers who are experienced in the aviation industry, so we understand the pain of endless nights with coding and coffee to meet deadlines. This is why we aimed to keep the Past Airport Schedules API as plain but effective as possible. Its easing optimization and ability to cache responses effectively are good reasons to choose this structure.

Code your project using Javascript, JQuery, VueJS, Angular, JAVA, PHP, NodeJS, Python, Go, Ruby, C#, R, Strest, Rust, Swift, Scala and more.


Example 200 OK Output and Full Documentation

When only the obligatory parameters of airport IATA code, schedule type and date, the Historical Airport Schedules API is programmed to return the complete schedule in a single call. It is possible to filter the flights in it by airline, flight number and more. As the example output, we will show you a single flight from the output to give you an idea.

The API returns past airport schedules data in JSON format. You can easily convert this to other formats should you need it. The response times are fast, completely within the industry standards.

API Output

{
  "status": {
    "message": "Success"
  },
  "results": {
    "status": {
      "message": "Success"
    },
    "results": {
      "airline": {
        "iataCode": "AF",
        "icaoCode": "AFR",
        "name": "Air France"
      },
      "arrival": {
        "actualRunway": "2022-08-11T11:48:00.000",
        "actualTime": "2022-08-11T11:48:00.000",
        "baggage": "05",
        "delay": null,
        "estimatedRunway": "2022-08-11T11:48:00.000",
        "estimatedTime": "2022-08-11T11:43:00.000",
        "gate": "2",
        "iataCode": "ORY",
        "icaoCode": "LFPO",
        "scheduledTime": "2022-08-11T12:00:00.000",
        "terminal": "2"
      },
      "departure": {
        "actualRunway": "2022-08-11T10:35:00.000",
        "actualTime": "2022-08-11T10:35:00.000",
        "baggage": "4",
        "delay": "6",
        "estimatedRunway": "2022-08-11T10:35:00.000",
        "estimatedTime": "2022-08-11T10:30:00.000",
        "gate": "2C",
        "iataCode": "NCE",
        "icaoCode": "LFMN",
        "scheduledTime": "2022-08-11T10:30:00.000",
        "terminal": "2"
      },
      "flight": {
        "iataNumber": "AF6209",
        "icaoNumber": "AFR6209",
        "number": "6209"
      },
      "status": "landed",
      "type": "arrival"
    }
  }
}
Enter fullscreen mode Exit fullscreen mode
Object Description
status Status of the API request
airline.iataCode The airline IATA code
airline.icaoCode The airline ICAO code
airline.name The name of the airline
arrival.actualRunway Actual runway time at arrival
arrival.actualTime Actual arrival time
arrival.baggage Baggage belt number
delay Flight delay measured in minutes
arrival.estimatedRunway Estimated runway arrival time
arrival.estimatedTime Estimated arrival time
arrival.gate Arrival gate
arrival.iataCode The IATA code of the arrival airport
arrival.icaoCode The ICAO code of the arrival airport
arrival.scheduledTime Scheduled arrival time
arrival.terminal Arrival terminal number
departure.actualRunway Actual runway departure time
departure.actualTime Actual departure time
departure.baggage Baggage claim number at departure airport
departure.delay Departure delay in minutes
departure.estimatedRunway Estimated runway departure time
departure.estimatedTime Estimated departure time
departure.gate Departure gate number
departure.iataCode Departure airport IATA code
departure.icaoCode Departure airport ICAO code
departure.scheduledTime Scheduled departure time
departure.terminal Departure terminal
flight.iataNumber The IATA flight number
flight.icaoNumber The ICAO flight number
flight.number The flight number
status Latest recorded flight status
type The type of flight data (arrival or departure)

Visit the full documentation for everything.

Documentation - Aviyair

Aviyair's documentation gives you all technical aspects of integrating the flight data into softwares or products. API response and requests are provided.

favicon aviyair.com

Note: In case you are looking for other flight details in the historical airport schedules data such as the aircraft details or real-time flight location, keep in mind that we have several other aviation APIs. These will cover anything else that is not in the Historical Airport Schedules API. If you have such a requirement, send us an email explaining it and let us guide you on how you can get this data at no additional costs. This is because the unique API key you get on our website will grant you access to all our APIs.

Image description


URL Examples with API Methods and Filters

The Past Airport Schedules API requests are all GET. The server is https://data.aviyair.com/data/v1/ and the endpoint is "/historicalschedule?" with many parameters available to use as filters.

Route Method Description
https://data.aviyair.com/data/v1/historicalschedule?key=APIKEY&airport_iata=CGK&type=departure&date_from=2023-01-01 GET Departure schedule of CGK on 2023-01-01
https://data.aviyair.com/data/v1/historicalschedule?key=APIKEY&airport_iata=CGK&type=departure&date_from=2023-01-01&date_to=2023-01-03&amo GET The complete departure schedule of CGK between 2023-01-01 and 2023-01-03 (3 days included)
https://data.aviyair.com/data/v1/historicalschedule?key=APIKEY&airport_iata=CGK&type=departure&date_from=2023-01-01&airline_iata=QZ GET Departure schedule of CGK on 2023-01-01 with every flight of Indonesia AirAsia
https://data.aviyair.com/data/v1/historicalschedule?key=APIKEY&airport_iata=CGK&type=departure&date_from=2023-01-01&airline_iata=QZ&flight_number=265 GET Delay data and other details for flight QZ265 on 2023-01-01

USEFUL TIPS CORNER

Coverage: Aviyair’s historical airport schedules data have GLOBAL coverage. No matter which markets you want your business to focus, the API’s got you covered!

Expert Support: If you are not sure how to draw a path for your use case or looking for ways to enhance it, feel free to send us an email and exchange ideas with one of our experts in the industry.

Marketing Opportunity: Online visibility matters. If you are looking for ways to increase the organic online visibility of your product powered by Aviyair’s past airport schedules data, we can talk about several affordable opportunities. Give us a holler if you are interested!


Summary and API Key Link

TL;DR, the past airport schedules API of Aviyair is a very convenient data tool to fetch historical airport timetable data. With all the useful details in the output such as airline details, airport details, scheduled/estimated/actual departure and arrival + runway times, flight number, flight and cancellation status, total delay, gate, terminal, baggage belt and more, for each flight in the response this **JSON REST **API is definitely a developer-friendly option. You can request one or multiple consecutive dates at once.

Accessing this API is very easy and takes 1 minute of your time. Simply go with a subscription plan below and receive your API key to your email. Great discounts apply for the first weeks so you can fully test and start integrating the API for basically nothing.

📌 Cancel anytime. You have full control over your access to the Historical Airport Timetables API.
Custom plans available. If you need fewer or more API calls than our fixed plans, we can get you a custom offer.

📌 No hidden fees. When you reach your limit, you will simply receive a message in the output and will not get charged unexpectedly. When you need more calls, simply upgrade your plan on your dashboard for immediate higher limits.

📌 Get support. With their background in aviation, Aviyair is here to help if you have any questions or for your support requests. Contact Aviyair here.


Get your API key and get ready to take-off! 🛫🛫🛫

Pricing - Aviyair

Aviyair offers three main subscriptions plans for flight schedules data, airport timetables and airline routes information.

  <div class="color-secondary fs-s flex items-center">
      <img
        alt="favicon"
        class="c-embed__favicon m-0 mr-2 radius-0"
        src="https://aviyair.com/wp-content/uploads/2022/08/cropped-cropped-aviyair-logo-32x32.png"
        loading="lazy" />
    aviyair.com
  </div>
</div>
Enter fullscreen mode Exit fullscreen mode

🛫

Top comments (0)