docs / flightaware

FlightAware API

base /flightaware/v13 endpoints

post/flightaware/v1/flight_status1 credit

Live status for one flight by ident or flight number. Returns origin/destination (airport name, IATA/ICAO, gate, terminal, timezone, coordinates), scheduled / estimated / actual times for gate-out, take-off, landing and gate-in, aircraft type, airline, trip progress (percent complete, miles flown/remaining), the live position (altitude, groundspeed, heading) when airborne, and the filed flight plan.

Parameter		Allowed / range	Description
ident	required	—	Flight identifier — an airline flight number in ICAO form (UAL100, DAL47, BAW178) or IATA form (UA100, DL47, BA178), or a registration/callsign. IATA is auto-resolved to the operating flight. The aircraft's most recent/active leg is returned.

Try in playground →

post/flightaware/v1/live_position1 credit

Live ADS-B track for one airborne flight: current position plus the full position history (lat/lon/altitude/groundspeed per timestamp) FlightAware has logged for this leg. Use flight_status first to confirm the flight is airborne. For grounded / arrived flights `position` is null and `track` is whatever was logged on the ground.

Parameter		Allowed / range	Description
ident	required	—	Flight identifier — an airline flight number in ICAO form (UAL100, DAL47, BAW178) or IATA form (UA100, DL47, BA178), or a registration/callsign. IATA is auto-resolved to the operating flight. The aircraft's most recent/active leg is returned.

Try in playground →

post/flightaware/v1/airport_board1 credit

Live activity board for an airport: the arrivals, departures, en-route or scheduled flights FlightAware shows for that airport. Each row gives the flight ident, aircraft type, the other airport (IATA), and the scheduled/estimated times. Feed an ident back into flight_status for full detail.

Parameter		Allowed / range	Description
airport	required	—	Airport code — ICAO (KJFK, EGLL, EDDF) or IATA (JFK, LHR, FRA). ICAO is the most reliable. Returns the live activity boards for that airport.
board = arrivals	optional	arrivals · departures · enroute · scheduled	Which activity board to return: arrivals, departures, enroute or scheduled.
limit = 20	optional	1–20	Max flights to return from the board (1-20; FlightAware renders ~20 per board to logged-out requests).

Try in playground →

Example request · flight_status

curl -X POST https://api.reefapi.com/flightaware/v1/flight_status \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"ident":"UAL100"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}