# Airport Schedule API V2

API endpoint for this API is: **`https://api.flightapi.io/schedule/v2`**

## Guide

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

You can generate an API key from your Dashboard at any time.

Here is the list of default parameters you have to use with this API:

| Parameters                                                      | Description                                                                                                                                                                  | Type     |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- |
| <p>api\_key<br><br><mark style="color:red;">required</mark></p> | This is your personal API key. You can find this on your Dashboard.                                                                                                          | `String` |
| <p>mode<br><br><mark style="color:red;">required</mark></p>     | <p>The value of mode could be either <strong><code>arrivals</code></strong> or <strong><code>departures</code></strong>.<br><br><mark style="color:red;">required</mark></p> | `String` |
| <p>year<br><br><mark style="color:red;">required</mark></p>     | <p>This represents the year.<br><br>Example values - <code>2025</code> or <code>2026</code></p>                                                                              | `String` |
| <p>month<br><br><mark style="color:red;">required</mark></p>    | <p>This could be any month of the year.<br><br>Example values - <code>01</code>, <code>06</code> or <code>12</code>.</p>                                                     | `String` |
| <p>day<br><br><mark style="color:red;">required</mark></p>      | This is the day of a month                                                                                                                                                   | `String` |
| <p>page<br><br><mark style="color:red;">required</mark></p>     | <p>For each day there are maximum 4 pages. <br><br>Possible values - 1,2,3 or 4.</p>                                                                                         | `String` |

{% hint style="info" %}
If you don't pass the day parameter then our API will respond with the complete schedule of the airport from the last 5 days to the next 5 days. Credit cost also depends on the number of days you receive.
{% endhint %}

## Usage

You have to send a GET request to  `https://api.flightapi.io/schedule` along with all the parameters.&#x20;

Check out sample API calls written in multiple programming languages.

{% tabs %}
{% tab title="curl" %}

```bash
curl "https://api.flightapi.io/schedule/v2/api_key?mode=dep&iata=JAI&year=2025&month=11&day=25&page=1
```

{% endtab %}

{% tab title="Node" %}

```javascript
// require the Unirest or any other module to make an HTTP GET request
const unirest = require('unirest')

unirest.get('https://api.flightapi.io/schedule/v2/api_key?mode=departures&iata=DOH&day=1')
  .then(response => {
    console.log(response.body);
  })
  .catch(error => {
    console.log(error);
  });


```

{% endtab %}

{% tab title="Python" %}

```python
import axios from "axios";

const url = "https://api.flightapi.io/schedule/v2/api_key";

const params = {
  mode: "dep",
  iata: "JAI",
  year: 2025,
  month: 11,
  day: 25,
  page: 1
};

async function fetchSchedule() {
  try {
    const response = await axios.get(url, { params });
    console.log(response.data);
  } catch (error) {
    console.error("Error fetching flight schedule:", error.message);
  }
}

fetchSchedule();


```

{% endtab %}
{% endtabs %}

### Response

The sample response of the API will look somewhat like this.

{% code overflow="wrap" fullWidth="false" %}

```json
{
    "data": {
        "header": {
            "date": "21-Nov-2025",
            "dateMDY": "Nov-21-2025",
            "title": "(JAI) Jaipur International Airport Departures",
            "mobileTitle": "JAI Departures",
            "departureAirport": {
                "fs": "JAI",
                "iata": "JAI",
                "icao": "VIJP",
                "name": "Jaipur International Airport",
                "city": "Jaipur",
                "state": "",
                "country": "IN",
                "active": true,
                "classification": 3,
                "timeZoneRegionName": "Asia/Kolkata"
            }
        },
        "destOriginTitle": "Destination",
        "flights": [
            {
                "sortTime": "2025-11-20T17:45:00.000Z",
                "departureTime": {
                    "timeAMPM": "11:15PM",
                    "time24": "23:15"
                },
                "arrivalTime": {
                    "timeAMPM": "1:10AM",
                    "time24": "01:10"
                },
                "carrier": {
                    "fs": "SG",
                    "name": "SpiceJet",
                    "flightNumber": "251"
                },
                "operatedBy": null,
                "url": "/flight-tracker/SG/251?year=2025&month=11&date=20&flightId=1352424334",
                "airport": {
                    "fs": "BOM",
                    "city": "Mumbai"
                }
            },
            {
                "sortTime": "2025-11-20T18:20:00.000Z",
                "departureTime": {
                    "timeAMPM": "11:50PM",
                    "time24": "23:50"
                },
                "arrivalTime": {
                    "timeAMPM": "1:00AM",
                    "time24": "01:00"
                },
                "carrier": {
                    "fs": "6E",
                    "name": "IndiGo",
                    "flightNumber": "5136"
                },
                "operatedBy": null,
                "url": "/flight-tracker/6E/5136?year=2025&month=11&date=20&flightId=1352341884",
                "airport": {
                    "fs": "DEL",
                    "city": "Delhi"
                }
            },
            {
                "sortTime": "2025-11-20T18:20:00.000Z",
                "departureTime": {
                    "timeAMPM": "11:50PM",
                    "time24": "23:50"
                },
                "arrivalTime": {
                    "timeAMPM": "1:00AM",
                    "time24": "01:00"
                },
                "carrier": {
                    "fs": "QF",
                    "name": "Qantas",
                    "flightNumber": "5398"
                },
                "operatedBy": "Operated by IndiGo 5136",
                "url": "/flight-tracker/QF/5398?year=2025&month=11&date=20&flightId=1352341884",
                "airport": {
                    "fs": "DEL",
                    "city": "Delhi"
                },
                "isCodeshare": true
            },
            {
                "sortTime": "2025-11-20T18:20:00.000Z",
                "departureTime": {
                    "timeAMPM": "11:50PM",
                    "time24": "23:50"
                },
                "arrivalTime": {
                    "timeAMPM": "1:00AM",
                    "time24": "01:00"
                },
                "carrier": {
                    "fs": "VS",
                    "name": "Virgin Atlantic",
                    "flightNumber": "8599"
                },
                "operatedBy": "Operated by IndiGo 5136",
                "url": "/flight-tracker/VS/8599?year=2025&month=11&date=20&flightId=1352341884",
                "airport": {
                    "fs": "DEL",
                    "city": "Delhi"
                },
                "isCodeshare": true
            },
            {
                "sortTime": "2025-11-20T18:25:00.000Z",
                "departureTime": {
                    "timeAMPM": "11:55PM",
                    "time24": "23:55"
                },
                "arrivalTime": {
                    "timeAMPM": "1:45AM",
                    "time24": "01:45"
                },
                "carrier": {
                    "fs": "6E",
                    "name": "IndiGo",
                    "flightNumber": "5166"
                },
                "operatedBy": null,
                "url": "/flight-tracker/6E/5166?year=2025&month=11&date=20&flightId=1352341935",
                "airport": {
                    "fs": "BOM",
                    "city": "Mumbai"
                }
            },
            {
                "sortTime": "2025-11-20T18:25:00.000Z",
                "departureTime": {
                    "timeAMPM": "11:55PM",
                    "time24": "23:55"
                },
                "arrivalTime": {
                    "timeAMPM": "1:45AM",
                    "time24": "01:45"
                },
                "carrier": {
                    "fs": "VS",
                    "name": "Virgin Atlantic",
                    "flightNumber": "8758"
                },
                "operatedBy": "Operated by IndiGo 5166",
                "url": "/flight-tracker/VS/8758?year=2025&month=11&date=20&flightId=1352341935",
                "airport": {
                    "fs": "BOM",
                    "city": "Mumbai"
                },
                "isCodeshare": true
            },
            {
                "sortTime": "2025-11-20T19:40:00.000Z",
                "departureTime": {
                    "timeAMPM": "1:10AM",
                    "time24": "01:10"
                },
                "arrivalTime": {
                    "timeAMPM": "3:55AM",
                    "time24": "03:55"
                },
                "carrier": {
                    "fs": "IX",
                    "name": "Air India Express",
                    "flightNumber": "195"
                },
                "operatedBy": null,
                "url": "/flight-tracker/IX/195?year=2025&month=11&date=21&flightId=1352577756",
                "airport": {
                    "fs": "DXB",
                    "city": "Dubai"
                }
            },
            {
                "sortTime": "2025-11-20T19:40:00.000Z",
                "departureTime": {
                    "timeAMPM": "1:10AM",
                    "time24": "01:10"
                },
                "arrivalTime": {
                    "timeAMPM": "3:55AM",
                    "time24": "03:55"
                },
                "carrier": {
                    "fs": "AI",
                    "name": "Air India",
                    "flightNumber": "9123"
                },
                "operatedBy": "Operated by Air India Express 195",
                "url": "/flight-tracker/AI/9123?year=2025&month=11&date=21&flightId=1352577756",
                "airport": {
                    "fs": "DXB",
                    "city": "Dubai"
                },
                "isCodeshare": true
            },
            {
                "sortTime": "2025-11-20T21:45:00.000Z",
                "departureTime": {
                    "timeAMPM": "3:15AM",
                    "time24": "03:15"
                },
                "arrivalTime": {
                    "timeAMPM": "5:50AM",
                    "time24": "05:50"
                },
                "carrier": {
                    "fs": "EY",
                    "name": "Etihad Airways",
                    "flightNumber": "329"
                },
                "operatedBy": null,
                "url": "/flight-tracker/EY/329?year=2025&month=11&date=21&flightId=1352563158",
                "airport": {
                    "fs": "AUH",
                    "city": "Abu Dhabi"
                }
            },
            {
                "sortTime": "2025-11-20T22:40:00.000Z",
                "departureTime": {
                    "timeAMPM": "4:10AM",
                    "time24": "04:10"
                },
                "arrivalTime": {
                    "timeAMPM": "6:20AM",
                    "time24": "06:20"
                },
                "carrier": {
                    "fs": "G9",
                    "name": "Air Arabia",
                    "flightNumber": "436"
                },
                "operatedBy": null,
                "url": "/flight-tracker/G9/436?year=2025&month=11&date=21&flightId=1352571091",
                "airport": {
                    "fs": "SHJ",
                    "city": "Sharjah"
                }
            },
            {
                "sortTime": "2025-11-20T23:45:00.000Z",
                "departureTime": {
                    "timeAMPM": "5:15AM",
                    "time24": "05:15"
                },
                "arrivalTime": {
                    "timeAMPM": "6:15AM",
                    "time24": "06:15"
                },
                "carrier": {
                    "fs": "SG",
                    "name": "SpiceJet",
                    "flightNumber": "9944"
                },
                "operatedBy": null,
                "url": "/flight-tracker/SG/9944?year=2025&month=11&date=21&flightId=1352952928",
                "airport": {
                    "fs": "DEL",
                    "city": "Delhi"
                }
            },
            {
                "sortTime": "2025-11-20T23:50:00.000Z",
                "departureTime": {
                    "timeAMPM": "5:20AM",
                    "time24": "05:20"
                },
                "arrivalTime": {
                    "timeAMPM": "7:30AM",
                    "time24": "07:30"
                },
                "carrier": {
                    "fs": "SG",
                    "name": "SpiceJet",
                    "flightNumber": "1077"
                },
                "operatedBy": null,
                "url": "/flight-tracker/SG/1077?year=2025&month=11&date=21&flightId=1352606014",
                "airport": {
                    "fs": "PNQ",
                    "city": "Pune"
                }
            },
            {
                "sortTime": "2025-11-21T00:05:00.000Z",
                "departureTime": {
                    "timeAMPM": "5:35AM",
                    "time24": "05:35"
                },
                "arrivalTime": {
                    "timeAMPM": "8:10AM",
                    "time24": "08:10"
                },
                "carrier": {
                    "fs": "6E",
                    "name": "IndiGo",
                    "flightNumber": "839"
                },
                "operatedBy": null,
                "url": "/flight-tracker/6E/839?year=2025&month=11&date=21&flightId=1352521518",
                "airport": {
                    "fs": "BLR",
                    "city": "Bengaluru"
                }
            },
            {
                "sortTime": "2025-11-21T00:05:00.000Z",
                "departureTime": {
                    "timeAMPM": "5:35AM",
                    "time24": "05:35"
                },
                "arrivalTime": {
                    "timeAMPM": "8:10AM",
                    "time24": "08:10"
                },
                "carrier": {
                    "fs": "QF",
                    "name": "Qantas",
                    "flightNumber": "8889"
                },
                "operatedBy": "Operated by IndiGo 839",
                "url": "/flight-tracker/QF/8889?year=2025&month=11&date=21&flightId=1352521518",
                "airport": {
                    "fs": "BLR",
                    "city": "Bengaluru"
                },
                "isCodeshare": true
            },
            {
                "sortTime": "2025-11-21T00:15:00.000Z",
                "departureTime": {
                    "timeAMPM": "5:45AM",
                    "time24": "05:45"
                },
                "arrivalTime": {
                    "timeAMPM": "7:50AM",
                    "time24": "07:50"
                },
                "carrier": {
                    "fs": "6E",
                    "name": "IndiGo",
                    "flightNumber": "6977"
                },
                "operatedBy": null,
                "url": "/flight-tracker/6E/6977?year=2025&month=11&date=21&flightId=1352520935",
                "airport": {
                    "fs": "GOX",
                    "city": "Goa"
                }
            },
            {
                "sortTime": "2025-11-21T00:20:00.000Z",
                "departureTime": {
                    "timeAMPM": "5:50AM",
                    "time24": "05:50"
                },
                "arrivalTime": {
                    "timeAMPM": "7:15AM",
                    "time24": "07:15"
                },
                "carrier": {
                    "fs": "6E",
                    "name": "IndiGo",
                    "flightNumber": "7742"
                },
                "operatedBy": null,
                "url": "/flight-tracker/6E/7742?year=2025&month=11&date=21&flightId=1352521448",
                "airport": {
                    "fs": "IXC",
                    "city": "Chandigarh"
                }
            },
            {
                "sortTime": "2025-11-21T00:30:00.000Z",
                "departureTime": {
                    "timeAMPM": "6:00AM",
                    "time24": "06:00"
                },
                "arrivalTime": {
                    "timeAMPM": "8:05AM",
                    "time24": "08:05"
                },
                "carrier": {
                    "fs": "AI",
                    "name": "Air India",
                    "flightNumber": "414"
                },
                "operatedBy": null,
                "url": "/flight-tracker/AI/414?year=2025&month=11&date=21&flightId=1352537438",
                "airport": {
                    "fs": "BOM",
                    "city": "Mumbai"
                }
            }
        ]
    }
}
```

{% endcode %}

{% hint style="info" %}
It is just a sample API response. Some objects will have more attributes. A new array might also be there.
{% endhint %}
