Real-Time Flights

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

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

fetch('https://api.flystack.dev/v1/flights', 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/flights",
  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/flights"

	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/flights")

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

[
  {
    "hex": "780695",
    "reg_number": "B-5545",
    "flag": "CN",
    "lat": 28.397377,
    "lng": 115.1008,
    "alt": 7078,
    "dir": 269,
    "speed": 775,
    "v_speed": -7.8,
    "squawk": "0205",
    "flight_number": "9429",
    "flight_icao": "CSH9429",
    "flight_iata": "FM9429",
    "dep_icao": "ZSPD",
    "dep_iata": "PVG",
    "arr_icao": "ZGHY",
    "arr_iata": "HNY",
    "airline_icao": "CSH",
    "airline_iata": "FM",
    "aircraft_icao": "B738",
    "updated": 1626153069,
    "status": "en-route"
  }
]

GET

flights

Real-Time Flights

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

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

fetch('https://api.flystack.dev/v1/flights', 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/flights",
  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/flights"

	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/flights")

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

[
  {
    "hex": "780695",
    "reg_number": "B-5545",
    "flag": "CN",
    "lat": 28.397377,
    "lng": 115.1008,
    "alt": 7078,
    "dir": 269,
    "speed": 775,
    "v_speed": -7.8,
    "squawk": "0205",
    "flight_number": "9429",
    "flight_icao": "CSH9429",
    "flight_iata": "FM9429",
    "dep_icao": "ZSPD",
    "dep_iata": "PVG",
    "arr_icao": "ZGHY",
    "arr_iata": "HNY",
    "airline_icao": "CSH",
    "airline_iata": "FM",
    "aircraft_icao": "B738",
    "updated": 1626153069,
    "status": "en-route"
  }
]

Integrate real-time flight tracking (live ADS-B style data) into your product: monitor individual flights, power flight status screens, visualize traffic on a map, or analyze airspace density and regularity.

Authentication

string

required

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

Query parameters

Area & performance

string

Bounding box: south_lat,south_lng,north_lat,north_lng.

number

Map zoom level to reduce the number of returned flights (0–11).

Aircraft / airline / flight filters

string

Filter by ICAO24 hex address.

string

Filter by aircraft registration number.

string

Filter by airline ICAO code.

string

Filter by airline IATA code.

string

Filter by airline country ISO-2 code.

string

Filter by flight ICAO code-number.

string

Filter by flight IATA code-number.

string

Filter by flight number only.

string

Filter by departure airport ICAO code.

string

Filter by departure airport IATA code.

string

Filter by arrival airport ICAO code.

string

Filter by arrival airport IATA code.

Response shaping

string

Comma-separated list of fields to return (e.g., hex,airline_iata,lat,lng).

string

default:"object"

View format:

object: default JSON objects
array: array rows (useful for browsers / fast rendering)

For _view=array, make sure _fields lists fields in the exact order you want in the returned arrays.

Response (object view)

Flight response fields

Show Live tracking

string

ICAO24 hex address.

number

Latitude.

number

Longitude.

number

Altitude (meters).

number

Heading (degrees).

number

Horizontal speed (km/h).

number

Vertical speed.

string

Squawk code (when available).

number

UNIX timestamp of last update.

string

Flight status (scheduled, en-route, landed).

Show Flight & airline identifiers

string

Flight number only.

string

Flight ICAO code-number.

string

Flight IATA code-number.

string

Airline ICAO code.

string

Airline IATA code.

Show Route

string

Departure airport ICAO code.

string

Departure airport IATA code.

string

Arrival airport ICAO code.

string

Arrival airport IATA code.

Show Aircraft

string

Aircraft registration number (when available).

string

ISO-2 country code (when available).

string

Aircraft ICAO type designator.

[
  {
    "hex": "780695",
    "reg_number": "B-5545",
    "flag": "CN",
    "lat": 28.397377,
    "lng": 115.1008,
    "alt": 7078,
    "dir": 269,
    "speed": 775,
    "v_speed": -7.8,
    "squawk": "0205",
    "flight_number": "9429",
    "flight_icao": "CSH9429",
    "flight_iata": "FM9429",
    "dep_icao": "ZSPD",
    "dep_iata": "PVG",
    "arr_icao": "ZGHY",
    "arr_iata": "HNY",
    "airline_icao": "CSH",
    "airline_iata": "FM",
    "aircraft_icao": "B738",
    "updated": 1626153069,
    "status": "en-route"
  }
]

Response (array view)

[
  ["140668", "NP", 55.879863, 37.159452, 310.1, 320],
  ["300164", "IT", 42.040581, 12.156564, 131, 1219]
]

Real-time

Datasets

Platform

Real-Time Flights

Authentication

Query parameters

Area & performance

Aircraft / airline / flight filters

Response shaping

Response (object view)

Flight response fields

Response (array view)

See also

​Authentication

​Query parameters

​Area & performance

​Aircraft / airline / flight filters

​Response shaping

​Response (object view)

​Flight response fields

​Response (array view)

​See also

Authentication

Query parameters

Area & performance

Aircraft / airline / flight filters

Response shaping

Response (object view)

Flight response fields

Response (array view)

See also