Flight Schedules

curl --request GET \
  --url https://api.flystack.dev/v1/schedules \
  --header 'x-api-key: <x-api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api.flystack.dev/v1/schedules', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flystack.dev/v1/schedules",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flystack.dev/v1/schedules"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.flystack.dev/v1/schedules")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "airline_iata": "BA",
    "airline_icao": "BAW",
    "flight_iata": "BA6984",
    "flight_icao": "BAW6984",
    "flight_number": "6984",
    "cs_airline_iata": "AA",
    "cs_flight_number": "2421",
    "cs_flight_iata": "AA2421",
    "dep_iata": "MIA",
    "dep_icao": "KMIA",
    "dep_terminal": "C",
    "dep_gate": "E4",
    "dep_time": "2021-07-14 19:53",
    "dep_time_ts": 1626306780,
    "dep_time_utc": "2021-07-14 23:53",
    "dep_estimated": "2021-07-14 22:10",
    "dep_estimated_ts": 1626315000,
    "dep_estimated_utc": "2021-07-15 02:10",
    "dep_actual": "2021-07-14 22:10",
    "dep_actual_ts": 1626315000,
    "dep_actual_utc": "2021-07-15 02:10",
    "arr_iata": "SFO",
    "arr_icao": "KSFO",
    "arr_terminal": "1",
    "arr_gate": "B24",
    "arr_baggage": "1",
    "arr_time": "2021-07-14 22:52",
    "arr_time_ts": 1626328320,
    "arr_time_utc": "2021-07-15 05:52",
    "arr_estimated": "2021-07-15 01:09",
    "arr_estimated_ts": 1626336540,
    "arr_estimated_utc": "2021-07-15 08:09",
    "arr_actual": "2021-07-15 01:09",
    "arr_actual_ts": 1626336540,
    "arr_actual_utc": "2021-07-15 08:09",
    "status": "scheduled",
    "duration": 359,
    "dep_delayed": 137,
    "arr_delayed": 137
  }
]

GET

schedules

Flight Schedules

curl --request GET \
  --url https://api.flystack.dev/v1/schedules \
  --header 'x-api-key: <x-api-key>'

const options = {method: 'GET', headers: {'x-api-key': '<x-api-key>'}};

fetch('https://api.flystack.dev/v1/schedules', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.flystack.dev/v1/schedules",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <x-api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.flystack.dev/v1/schedules"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<x-api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.flystack.dev/v1/schedules")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<x-api-key>'

response = http.request(request)
puts response.read_body

[
  {
    "airline_iata": "BA",
    "airline_icao": "BAW",
    "flight_iata": "BA6984",
    "flight_icao": "BAW6984",
    "flight_number": "6984",
    "cs_airline_iata": "AA",
    "cs_flight_number": "2421",
    "cs_flight_iata": "AA2421",
    "dep_iata": "MIA",
    "dep_icao": "KMIA",
    "dep_terminal": "C",
    "dep_gate": "E4",
    "dep_time": "2021-07-14 19:53",
    "dep_time_ts": 1626306780,
    "dep_time_utc": "2021-07-14 23:53",
    "dep_estimated": "2021-07-14 22:10",
    "dep_estimated_ts": 1626315000,
    "dep_estimated_utc": "2021-07-15 02:10",
    "dep_actual": "2021-07-14 22:10",
    "dep_actual_ts": 1626315000,
    "dep_actual_utc": "2021-07-15 02:10",
    "arr_iata": "SFO",
    "arr_icao": "KSFO",
    "arr_terminal": "1",
    "arr_gate": "B24",
    "arr_baggage": "1",
    "arr_time": "2021-07-14 22:52",
    "arr_time_ts": 1626328320,
    "arr_time_utc": "2021-07-15 05:52",
    "arr_estimated": "2021-07-15 01:09",
    "arr_estimated_ts": 1626336540,
    "arr_estimated_utc": "2021-07-15 08:09",
    "arr_actual": "2021-07-15 01:09",
    "arr_actual_ts": 1626336540,
    "arr_actual_utc": "2021-07-15 08:09",
    "status": "scheduled",
    "duration": 359,
    "dep_delayed": 137,
    "arr_delayed": 137
  }
]

Build timetables and “what’s next” experiences using live flight schedules. Schedules are ideal for airport-style boards, lounge/terminal displays, travel assistants, bots, widgets, and any product that needs the latest departure/arrival queue.

Schedules typically return results up to ~10 hours ahead (coverage may vary).

Authentication

string

required

Your FlyStack API token. You can create one from the dashboard (see Authentication).

Query parameters

You can query schedules by airport, airline, or specific flight codes.

Airport filters

string

Departure airport IATA code (e.g., MIA).

string

Departure airport ICAO code (e.g., KMIA).

string

Arrival airport IATA code (e.g., SFO).

string

Arrival airport ICAO code (e.g., KSFO).

Airline filters

string

Query by one airline IATA code, or provide multiple IATA codes when querying by airport (comma-separated).

string

Query by one airline ICAO code, or provide multiple ICAO codes when querying by airport (comma-separated).

Flight filters

string

Query by flight ICAO code-number (e.g., BAW6984).

string

Query by flight IATA code-number (e.g., BA6984).

Response shaping & pagination

string

Comma-separated list of fields to return (e.g., airline_iata,flight_number).

number

Maximum number of results (limits may depend on your plan and query type).

number

Pagination offset (0+). Use with limit when a response indicates there are more results.

Response

The endpoint returns a list of schedule entries.

Flight schedule response fields

Show Airline & flight identifiers

string

Airline IATA code.

string

Airline ICAO code.

string

Flight IATA code-number.

string

Flight ICAO code-number.

string

Flight number only.

string

Codeshare airline IATA code (when available).

string

Codeshare flight number (when available).

string

Codeshare flight IATA code-number (when available).

Show Departure

string

Departure airport IATA code.

string

Departure airport ICAO code.

string

Estimated departure terminal (when available).

string

Estimated departure gate (when available).

Show Arrival

string

Arrival airport IATA code.

string

Arrival airport ICAO code.

string

Estimated arrival terminal (when available).

string

Estimated arrival gate (when available).

string

Estimated baggage belt (when available).

Show Times (scheduled / estimated / actual)

string

Scheduled departure time (local).

number

Scheduled departure time (unix).

string

Scheduled departure time (UTC).

string

Estimated departure time (local, when available).

number

Estimated departure time (unix, when available).

string

Estimated departure time (UTC, when available).

string

Actual departure time (local, when available).

number

Actual departure time (unix, when available).

string

Actual departure time (UTC, when available).

string

Scheduled arrival time (local).

number

Scheduled arrival time (unix).

string

Scheduled arrival time (UTC).

string

Estimated arrival time (local, when available).

number

Estimated arrival time (unix, when available).

string

Estimated arrival time (UTC, when available).

string

Actual arrival time (local, when available).

number

Actual arrival time (unix, when available).

string

Actual arrival time (UTC, when available).

Show Status & derived fields

number

Estimated flight duration (minutes).

number

Estimated departure delay (minutes, when available).

number

Estimated arrival delay (minutes, when available).

string

scheduled, cancelled, active, landed.

[
  {
    "airline_iata": "BA",
    "airline_icao": "BAW",
    "flight_iata": "BA6984",
    "flight_icao": "BAW6984",
    "flight_number": "6984",
    "cs_airline_iata": "AA",
    "cs_flight_number": "2421",
    "cs_flight_iata": "AA2421",
    "dep_iata": "MIA",
    "dep_icao": "KMIA",
    "dep_terminal": "C",
    "dep_gate": "E4",
    "dep_time": "2021-07-14 19:53",
    "dep_time_ts": 1626306780,
    "dep_time_utc": "2021-07-14 23:53",
    "dep_estimated": "2021-07-14 22:10",
    "dep_estimated_ts": 1626315000,
    "dep_estimated_utc": "2021-07-15 02:10",
    "dep_actual": "2021-07-14 22:10",
    "dep_actual_ts": 1626315000,
    "dep_actual_utc": "2021-07-15 02:10",
    "arr_iata": "SFO",
    "arr_icao": "KSFO",
    "arr_terminal": "1",
    "arr_gate": "B24",
    "arr_baggage": "1",
    "arr_time": "2021-07-14 22:52",
    "arr_time_ts": 1626328320,
    "arr_time_utc": "2021-07-15 05:52",
    "arr_estimated": "2021-07-15 01:09",
    "arr_estimated_ts": 1626336540,
    "arr_estimated_utc": "2021-07-15 08:09",
    "arr_actual": "2021-07-15 01:09",
    "arr_actual_ts": 1626336540,
    "arr_actual_utc": "2021-07-15 08:09",
    "status": "scheduled",
    "duration": 359,
    "dep_delayed": 137,
    "arr_delayed": 137
  }
]

Real-time

Datasets

Platform

Flight Schedules

Authentication

Query parameters

Airport filters

Airline filters

Flight filters

Response

Flight schedule response fields

See also

​Authentication

​Query parameters

​Airport filters

​Airline filters

​Flight filters

​Response shaping & pagination

​Response

​Flight schedule response fields

​See also

Authentication

Query parameters

Airport filters

Airline filters

Flight filters

Response shaping & pagination

Response

Flight schedule response fields

See also