How to Integrate Aviyair’s Future Airport Schedules API
Tags: airport, api, airportschedules, airportdata
Published: 2023-05-29 07:08:00

In this article, we will give you a checklist of the basics to go over when integrating [**Aviyair’s Future Airport Schedules API**](https://aviyair.com/future-airport-schedules-api-with-instant-access/). If you are looking to display airport schedules based on a future date input, this API is just for you. We developed this API by taking into consideration what our peers in the travel and aviation industries would look for in a data source. Our background in the industry was a great help to determine the details included in the output as well as the structure of this **JSON REST API**. We are confident that you will find ease in this API, so keep on scrolling! **(API key link below)**

<ol>
  <li><a href="#decide-how-you-want-to-implement-the-API">Decide How You Want to Implement the API</a></li>
  <li><a href="#get-your-future-airport-schedules-api-key">Get Your Future Airport Schedules API Key</a></li>
  <li><a href="#available-api-methods-and-parameters">Available API Methods and Parameters</a></li>
  <li><a href="#output-example-and-data-object-descriptions">Output Example and Data Object Descriptions</a></li>
  <li><a href="#user-interface-(friendly-reminder)">User Interface (Friendly Reminder)</a></li>
  <li><a href="#conclusion-and-API-key-link">Conclusion and API Key Link</a></li>
</ol>

----

## Decide How You Want to Implement the API

To successfully integrate the Future Airport Schedules API by Aviyair, it would probably be wise to decide how you’d like to set up your local development environment. First, see which server-side language to use for the integration. Luckily, this is a JSON REST API so its structure allows you to work with pretty much any language you want, like Python, PHP, Ruby, Swift, JavaScript, Go, etc.

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

----

## Get Your Future Airport Schedules API Key

Needless to say, you will need an API key to access the future airport schedules data. Do this in 2 ways depending on the scale of your project:

1)	Create a subscription below and get your API key to your email immediately, with Premium monthly API call limits. Choose the best plan for you based on how many API calls you will need per month. Keep in mind that you can cancel a subscription anytime before it renews every monh and there are no hidden fees in case you reach your limit. If this happens, you will simply receive an error about reaching the limit. Then, you can easily upgrade your plan to higher limits right away.

{% embed https://aviyair.com/pricing-subscription-plans/ %}

2)	If you are on a tight budget or just would like to make a few calls to see what the data looks like, send us an email for a free test key. The test key we will send you will still give you access to the complete future airport schedules API but with a lower API call limit.

----

## Available API Methods and Parameters

After getting your Future Airport Schedules API key, check out how you can filter the data. Do you want to display the whole schedule for a future date or, for example, flights of a certain airline only? Or perhaps an individual flight based on its number. There are many parameters you can use to filter the data. All routes use the GET method.

<table>
  <thead>
    <tr>
      <th>Route</th>
      <th>Method</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>https://data.aviyair.com/data/v1/futureschedule?key=APIKEY&amp;airport_iata=CGK&amp;type=departure&amp;date=2024-02-17</td>
      <td>GET</td>
      <td>Complete departure schedule of CGK on 2024-02-17</td>
    </tr>
    <tr>
      <td>https://data.aviyair.com/data/v1/futureschedule?key=APIKEY&amp;airport_iata=CGK&amp;type=arrival&amp;date=2024-02-17&amp;airline_iata=QZ</td>
      <td>GET</td>
      <td>All flights of Indonesia AirAsia arriving at CGK on 2024-02-17</td>
    </tr>
    <tr>
      <td>https://data.aviyair.com/data/v1/futureschedule?key=APIKEY&amp;airport_iata=CGK&amp;type=departure&amp;date=2024-02-17&amp;airline_iata=QZ&amp;flight_number=265</td>
      <td>GET</td>
      <td>Data on flight QZ265, scheduled to take off on 2024-02-17 from CGK</td>
    </tr>
  </tbody>
</table>

If you prefer, you can use ICAO codes instead of IATA as these are supported, too. For example, “airport_icao=”, “airline_icao=”, etc., are available. Full list of parameters are in the documentation.

**Keep in mind:** Aviyair’s Future Airport Schedules data has **GLOBAL** coverage, meaning you can fetch all international airports worldwide. 

----

## Output Example and Data Object Descriptions

Let’s take a look at what the output looks like for the future airport schedules data. In addition to the example output, you will find below a table of the objects and their descriptions in more detail. See if the API includes all details you are looking for. For anything else that’s missing, our other APIs can be the answer, so send us an email before considering looking for another provider and splitting your data sources, as this would not be a very time and cost-friendly solution. You can access many APIs of Aviyair **with the same API key**, so that’s definitely a plus.

### API Output
```
{
  "status": {
    "message": "Success"
  },
  "results": {
    "weekday": "3",
    "departure": {
      "iataCode": "lgw",
      "icaoCode": "egkk",
      "terminal": "s",
      "gate": "2",
      "scheduledTime": "17:45"
    },
    "arrival": {
      "iataCode": "dub",
      "icaoCode": "eidw",
      "terminal": "1",
      "gate": "02",
      "scheduledTime": "19:00"
    },
    "aircraft": {
      "modelCode": "b738",
      "modelText": "boeing 737-8as"
    },
    "airline": {
      "name": "ryanair",
      "iataCode": "fr",
      "icaoCode": "ryr"
    },
    "flight": {
      "number": "113",
      "iataNumber": "fr113",
      "icaoNumber": "ryr113"
    }
  }
}
```


<table>
  <thead>
    <tr>
      <th>Object</th>
      <th>Description</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>status.message</td>
      <td>Status of the API request</td>
    </tr>
    <tr>
      <td>weekday</td>
      <td>Day of the week of the requested date</td>
    </tr>
    <tr>
      <td>departure.iataCode</td>
      <td>The IATA code of the departure airport</td>
    </tr>
    <tr>
      <td>departure.icaoCode</td>
      <td>The ICAO code of the departure airport</td>
    </tr>
    <tr>
      <td>departure.terminal</td>
      <td>The terminal of the departure airport</td>
    </tr>
    <tr>
      <td>departure.gate</td>
      <td>The gate number at the departure airport</td>
    </tr>
    <tr>
      <td>departure.scheduledTime</td>
      <td>The originally scheduled departure time</td>
    </tr>
    <tr>
      <td>arrival.iataCode</td>
      <td>The IATA code of the arrival airport</td>
    </tr>
    <tr>
      <td>arrival.icaoCode</td>
      <td>The ICAO code of the arrival airport</td>
    </tr>
    <tr>
      <td>arrival.terminal</td>
      <td>The terminal of the arrival airport</td>
    </tr>
    <tr>
      <td>arrival.gate</td>
      <td>The gate number at the arrival airport</td>
    </tr>
    <tr>
      <td>arrival.scheduledTime</td>
      <td>The originally scheduled arrival time</td>
    </tr>
    <tr>
      <td>aircraft.modelCode</td>
      <td>The aircraft model code</td>
    </tr>
    <tr>
      <td>aircraft.modelText</td>
      <td>The aircraft model name</td>
    </tr>
    <tr>
      <td>airline.name</td>
      <td>The name of the airline</td>
    </tr>
    <tr>
      <td>airline.iataCode</td>
      <td>The IATA code of the airline</td>
    </tr>
    <tr>
      <td>airline.icaoCode</td>
      <td>The ICAO code of the airline</td>
    </tr>
    <tr>
      <td>flight.number</td>
      <td>The flight number</td>
    </tr>
    <tr>
      <td>flight.iataNumber</td>
      <td>The IATA flight number</td>
    </tr>
    <tr>
      <td>flight.icaoNumber</td>
      <td>The ICAO flight number</td>
    </tr>
  </tbody>
</table>

----

Visit the full documentation below.

{% embed https://aviyair.com/documentation/ %}

----

## User Interface Friendly Reminder

Being in the industry for quite a while, we are aware of how intense the competition is. We have many clients who successfully launch their Future Airport Schedule API-integrated projects, but at the end of the day, the traffic you get depends on your marketing and UI skills. Now that you don’t have to spend time and an excessive amount of money on the data (ahem), make sure to pay close attention to your marketing and UI building budget and methods as this may be the determinant in your commercial success.

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

**Tip:** If you are looking for marketing opportunities for your products powered by our data, feel free to send us an email to discuss opportunities!

----

## Conclusion and API Key Link

Sounds interesting so far? To immediately access the Future Airport Timetables API with low costs, professional support, and global airport timetable data with departure/arrival airport, flight times, airline details, aircraft model, and more, spend 1 minute only and get your API key below. For any questions you have or to request support after getting your API key, [**contact Aviyair anytime.**](https://aviyair.com/contact-aviyair/)

{% embed https://aviyair.com/pricing-subscription-plans/ %}

**Tip:** If you don’t find any of the fixed plans suitable, we can talk about a custom plan, tailored to your requirements. 

**Final Tip:** Are you looking to use the Future Airline Timetables API for a non-profit or academic project? Are you on a very tight budget? Let us know and let’s discuss a free API key or discount opportunity!