Skip to main content
GET
/
v1
/
flights
/
lookup
Flight Lookup
curl --request GET \
  --url https://api.flystack.dev/v1/flights/lookup \
  --header 'x-api-key: <x-api-key>'
{
  "hex": "AAB812",
  "reg_number": "N790AN",
  "aircraft_icao": "B772",
  "flag": "US",
  "lat": 33.455017,
  "lng": -118.738312,
  "alt": 10668,
  "dir": 80,
  "speed": 942,
  "v_speed": 0,
  "squawk": "3726",
  "airline_icao": "AAL",
  "airline_iata": "AA",
  "flight_number": "6",
  "flight_icao": "AAL6",
  "flight_iata": "AA6",
  "cs_airline_iata": null,
  "cs_flight_number": null,
  "cs_flight_iata": null,
  "dep_icao": "PHOG",
  "dep_iata": "OGG",
  "dep_terminal": null,
  "dep_gate": "29",
  "dep_time": "2021-07-21 18:50",
  "dep_time_ts": 1626929400,
  "dep_time_utc": "2021-07-22 04:50",
  "arr_icao": "KDFW",
  "arr_iata": "DFW",
  "arr_terminal": "A",
  "arr_gate": "A24",
  "arr_baggage": "A28",
  "arr_time": "2021-07-22 07:04",
  "arr_time_ts": 1626955440,
  "arr_time_utc": "2021-07-22 12:04",
  "duration": 434,
  "delayed": null,
  "dep_delayed": null,
  "arr_delayed": null,
  "updated": 1626858778,
  "status": "en-route",
  "age": 6,
  "built": 2015,
  "engine": "jet",
  "engine_count": "2",
  "model": "Airbus A321-100/200 Ceo",
  "manufacturer": "AIRBUS",
  "msn": "5938",
  "type": "landplane"
}
The Flight Lookup API combines schedule data, near real-time tracking, and aircraft details for a single scheduled & live flight. It’s ideal for flight detail screens: status changes, times, gates, terminals, and aircraft information in one response.
This endpoint returns the closest matching flight (live, scheduled, or landed). If you need all occurrences of a flight number across a day, use the Flight Schedules API and query by flight_iata or flight_icao.

​
Authentication

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

​
Query parameters

​
flight_icao
string
Search by flight ICAO code-number (e.g., AAL6).
​
flight_iata
string
Or search by flight IATA code-number (e.g., AA6).
Provide either flight_iata or flight_icao.

​
Response

{
  "hex": "AAB812",
  "reg_number": "N790AN",
  "aircraft_icao": "B772",
  "flag": "US",
  "lat": 33.455017,
  "lng": -118.738312,
  "alt": 10668,
  "dir": 80,
  "speed": 942,
  "v_speed": 0,
  "squawk": "3726",
  "airline_icao": "AAL",
  "airline_iata": "AA",
  "flight_number": "6",
  "flight_icao": "AAL6",
  "flight_iata": "AA6",
  "cs_airline_iata": null,
  "cs_flight_number": null,
  "cs_flight_iata": null,
  "dep_icao": "PHOG",
  "dep_iata": "OGG",
  "dep_terminal": null,
  "dep_gate": "29",
  "dep_time": "2021-07-21 18:50",
  "dep_time_ts": 1626929400,
  "dep_time_utc": "2021-07-22 04:50",
  "arr_icao": "KDFW",
  "arr_iata": "DFW",
  "arr_terminal": "A",
  "arr_gate": "A24",
  "arr_baggage": "A28",
  "arr_time": "2021-07-22 07:04",
  "arr_time_ts": 1626955440,
  "arr_time_utc": "2021-07-22 12:04",
  "duration": 434,
  "delayed": null,
  "dep_delayed": null,
  "arr_delayed": null,
  "updated": 1626858778,
  "status": "en-route",
  "age": 6,
  "built": 2015,
  "engine": "jet",
  "engine_count": "2",
  "model": "Airbus A321-100/200 Ceo",
  "manufacturer": "AIRBUS",
  "msn": "5938",
  "type": "landplane"
}
If there is no result, you can often find future occurrences using the Routes Dataset.

​
See also