Flight Schedules
curl --request GET \
--url https://api.flystack.dev/v1/schedules \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.flystack.dev/v1/schedules"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://api.flystack.dev/v1/schedules")
.header("x-api-key", "<x-api-key>")
.asString();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
}
]
Real-time
Flight Schedules
Retrieve near real-time departure and arrival schedules, including gates, terminals, and updated times.
GET
/
v1
/
schedules
Flight Schedules
curl --request GET \
--url https://api.flystack.dev/v1/schedules \
--header 'x-api-key: <x-api-key>'import requests
url = "https://api.flystack.dev/v1/schedules"
headers = {"x-api-key": "<x-api-key>"}
response = requests.get(url, headers=headers)
print(response.text)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))
}HttpResponse<String> response = Unirest.get("https://api.flystack.dev/v1/schedules")
.header("x-api-key", "<x-api-key>")
.asString();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
Show Airline & flight identifiers
Show Departure
Show Departure
Show Arrival
Show Arrival
Show Times (scheduled / estimated / actual)
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).
[
{
"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
}
]