Skip to main content
GET
/
v1
/
flights
Real-Time Flights
curl --request GET \
  --url https://api.flystack.dev/v1/flights \
  --header 'x-api-key: <x-api-key>'
[
  {
    "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

​
x-api-key
string
required
Your FlyStack API token. You can create one from the dashboard (see Authentication).

​
Query parameters

​
Area & performance

​
bbox
string
Bounding box: south_lat,south_lng,north_lat,north_lng.
​
zoom
number
Map zoom level to reduce the number of returned flights (0–11).

​
Aircraft / airline / flight filters

​
hex
string
Filter by ICAO24 hex address.
​
reg_number
string
Filter by aircraft registration number.
​
airline_icao
string
Filter by airline ICAO code.
​
airline_iata
string
Filter by airline IATA code.
​
flag
string
Filter by airline country ISO-2 code.
​
flight_icao
string
Filter by flight ICAO code-number.
​
flight_iata
string
Filter by flight IATA code-number.
​
flight_number
string
Filter by flight number only.
​
dep_icao
string
Filter by departure airport ICAO code.
​
dep_iata
string
Filter by departure airport IATA code.
​
arr_icao
string
Filter by arrival airport ICAO code.
​
arr_iata
string
Filter by arrival airport IATA code.

​
Response shaping

​
_fields
string
Comma-separated list of fields to return (e.g., hex,airline_iata,lat,lng).
​
_view
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

[
  {
    "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]
]

​
See also