Skip to main content
GET
/
v1
/
fleets
Aircraft Fleets Dataset
curl --request GET \
  --url https://api.flystack.dev/v1/fleets \
  --header 'x-api-key: <x-api-key>'
[
  {
    "hex": "A9D286",
    "reg_number": "N732AN",
    "flag": "US",
    "airline_icao": "AAL",
    "airline_iata": "AA",
    "last_seen": 172540,
    "icao": "B77W",
    "iata": "77W",
    "model": "Boeing 777-300ER pax",
    "engine": "jet",
    "engine_count": "2",
    "manufacturer": "BOEING",
    "type": "landplane",
    "category": "H",
    "built": 2015,
    "age": 6,
    "msn": "31549",
    "line": "1257",
    "lat": 25.263,
    "lng": 51.612,
    "alt": 0,
    "dir": 67,
    "speed": 1,
    "v_speed": 0,
    "squawk": "0000"
  }
]
Augment your product with aircraft fleet data: display aircraft model/type, estimate fleet age, enrich flight tracking experiences, and improve the overall quality of information in your UI.

​
Authentication

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

​
Query parameters

​
Pagination

​
limit
number
Max number of rows per response (limits may depend on your plan).
​
offset
number
Pagination offset (0+). Use with limit when a response indicates there are more results.

​
Filters

​
airline_iata
string
Filter by airline IATA code (e.g., AA).
​
airline_icao
string
Filter by airline ICAO code (e.g., AAL).
​
hex
string
Filter by ICAO24 hex address.
​
reg_number
string
Filter by aircraft registration number.
​
msn
string
Filter by manufacturer serial number (MSN).
​
flag
string
Filter by country ISO-2 code.

​
Response shaping

​
_fields
string
Comma-separated list of fields to return (e.g., hex,airline_iata,manufacturer).
Latest GEO fields (lat/lng/alt/dir/speed/v_speed/squawk/last_seen) are typically available when querying by msn, hex, or reg_number (coverage may vary).

​
Response

The endpoint returns a list of aircraft.

​
Aircraft fleet response fields

[
  {
    "hex": "A9D286",
    "reg_number": "N732AN",
    "flag": "US",
    "airline_icao": "AAL",
    "airline_iata": "AA",
    "last_seen": 172540,
    "icao": "B77W",
    "iata": "77W",
    "model": "Boeing 777-300ER pax",
    "engine": "jet",
    "engine_count": "2",
    "manufacturer": "BOEING",
    "type": "landplane",
    "category": "H",
    "built": 2015,
    "age": 6,
    "msn": "31549",
    "line": "1257",
    "lat": 25.263,
    "lng": 51.612,
    "alt": 0,
    "dir": 67,
    "speed": 1,
    "v_speed": 0,
    "squawk": "0000"
  }
]

​
See also