सभी
Firehose Documentation Center
messages
Messages
Messages have two categories of data fields, "Mandatory" and "Optional":
- Mandatory fields must be included in every message.
- Optional fields are not provided by some sources, but provide important additional information to improve the quality of flight tracking.
Messages with the same feed type can be requested together in the "events" command.
Mandatory Fields
Summary
Field Name
Description
Summary
Arrival Time
Field Name
aat
Description
POSIX epoch format
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Arrival Time Type
Field Name
timeType
Description
Possible values are "actual", "estimated", or "enroute"
Summary
Message type
Field Name
type
Description
Value is always arrival
Optional Fields
Summary
Field Name
Description
Summary
ATC Ident
Field Name
atcident
Description
Identifier used for ATC, if it differs from flight identifier
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Estimated Departure Time
Field Name
edt
Description
Revised timestamp of when the flight is expected to depart. POSIX epoch format
Summary
ETA
Field Name
eta
Description
Estimated Time of Arrival. POSIX epoch format
Summary
En route Time
Field Name
ete
Description
In seconds. May be missing if not known.
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
Synthetic flag
Field Name
synthetic
Description
Boolean used to indicate if the arrival was triggered by some event other than an explicit arrival message. 1 indicates true, 0 indicates false.
Mandatory Fields
Summary
Field Name
Description
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always cancellation
Optional Fields
Summary
Field Name
Description
Summary
Aircraft Type
Field Name
aircrafttype
Description
FAA or ICAO aircraft type code
Summary
Filed cruising altitude
Field Name
alt
Description
In feet (MSL)
Summary
ATC Ident
Field Name
atcident
Description
Identifier used for ATC, if it differs from flight identifier
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Estimated Departure Time
Field Name
edt
Description
Revised timestamp of when the flight is expected to depart. POSIX epoch format
Summary
ETA
Field Name
eta
Description
Estimated Time of Arrival. POSIX epoch format
Summary
En route Time
Field Name
ete
Description
In seconds. May be missing if not known.
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Filed Departure Time
Field Name
fdt
Description
Timestamp that was originally listed in the filed flight plan for the departure. POSIX epoch format
Summary
Groundspeed
Field Name
gs
Description
In knots
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
New FlightAware flight id
Field Name
newId
Description
When this value is present, it indicates that this flight has been automatically cancelled by FlightAware because it has been detected to have been duplicately tracked. Applications can continue tracking of this flight by processing subsequent messages that contain an "id" field matching this new preferred value. (version 23.0+)
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
Text route
Field Name
route
Description
Textual route string
Summary
Filed cruising speed
Field Name
speed
Description
In knots
Summary
Flight Status
Field Name
status
Description
Single letter code for current flight status, can be S Scheduled, F Filed, A Active, Z Completed, or X Cancelled.
Summary
True Cancellation
Field Name
trueCancel
Description
Set to 1 when a confirmed flight cancellation was received from the airline. A value of 0 or lack of this field means that this is a presumed cancellation due to expiration or lack of data. (version 10.0+)
Summary
Uncancel
Field Name
uncancel
Description
Set to 1 when a previously cancelled flight is no longer cancelled. A value of 0 or lack of this field means that this flight does not have an uncancel event and is thus still cancelled. Field will only be present in data after May 9, 2025. (version 34.0+)
Summary
Waypoints
Field Name
waypoints
Description
2D, 3D, or 4D objects of locations, times, and altitudes formatted as a JSON array
Departure indicates a flight has departed off the runway (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
Departure Time
Field Name
adt
Description
POSIX epoch format
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
ICAO airline code plus IATA/ticketing flight number
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always departure
Optional Fields
Summary
Field Name
Description
Summary
Arrival Time
Field Name
aat
Description
POSIX epoch format
Summary
Aircraft Type
Field Name
aircrafttype
Description
ICAO aircraft type code
Summary
ATC Ident
Field Name
atcident
Description
Identifier used for ATC, if it differs from flight identifier
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Estimated Departure Time
Field Name
edt
Description
Revised timestamp of when the flight is expected to depart. POSIX epoch format
Summary
ETA
Field Name
eta
Description
Estimated Time of Arrival. POSIX epoch format
Summary
En route Time
Field Name
ete
Description
In seconds. May be missing if not known.
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
Synthetic flag
Field Name
synthetic
Description
Boolean used to indicate if the departure was triggered by some event other than an explicit departure message. 1 indicates true, 0 indicates false.
Summary
Departure Time Type
Field Name
timeType
Description
Possible values are "actual", "estimated", or "enroute"
Mandatory Fields
Summary
Field Name
Description
Summary
Error message
Field Name
error_msg
Description
Details of the error encountered
Summary
Message type
Field Name
type
Description
Value is always error
Extended_predictions includes greater depth of detail and context for Foresight predictions (which are included in the flifo message), most notably prediction quantiles. Requires Foresight Predictions to be enabled on user account. (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always extended_predictions
Optional Fields
Summary
Field Name
Description
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair. May be missing if not known.
Summary
Foresight Quantiles
Field Name
predicted_taxi_out_quantiles
Description
Supports scenarios where the median taxi out duration prediction (found in flifo message) may not provide sufficient context. Presented as a set of JSON percentile-duration key-value pairs. Example 5th percentile "5" is 496 seconds predicted taxi out duration and the 95th percentile "95" is 1955 seconds.
Summary
Scheduled Out
Field Name
scheduled_out
Description
The scheduled out (gate departure) time. (POSIX epoch format)
Flifo messages are used for all Flight Information (flifo) status updates for a flight, from pre-departure through arrival with scheduled, estimated, predicted, and actual updates. Flifo messages should be consumed along with 'departure', 'arrival', and 'cancellation' messages for complete monitoring of a flight.
All 'predicted' flifo values are generated by FlightAware's Foresight Machine Learning models, providing industry leading accuracy and unprecedented insight into operational efficiency. User account must also have 'FlightAware Foresight' enabled to receive the predicted values. (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always flifo
Optional Fields
Summary
Field Name
Description
Summary
Actual Arrival Gate
Field Name
actual_arrival_gate
Description
The gate at which the plane has arrived (requires extended flight info permission).
Summary
Actual Arrival Terminal
Field Name
actual_arrival_terminal
Description
The terminal at which the plane has arrived (requires extended flight info permission).
Summary
Actual Departure Gate
Field Name
actual_departure_gate
Description
The gate from which the plane has departed (requires extended flight info permission).
Summary
Actual Departure Terminal
Field Name
actual_departure_terminal
Description
The terminal at which the plane has departed (requires extended flight info permission).
Summary
Actual In
Field Name
actual_in
Description
The actual in (gate arrival) time (POSIX epoch format / requires extended flight info permission).
Summary
Actual Departure Time
Field Name
actual_off
Description
Timestamp of when the flight actually departed (POSIX epoch format).
Summary
Actual Arrival Time
Field Name
actual_on
Description
Time the aircraft touched down at the airport (POSIX epoch format).
Summary
Actual Out
Field Name
actual_out
Description
The actual out (gate departure) time (POSIX epoch format / requires extended flight info permission).
Summary
Actual Departure Runway
Field Name
actual_runway_off
Description
The runway from which the plane departed.
Summary
Actual Arrival Runway
Field Name
actual_runway_on
Description
The runway on which the plane landed.
Summary
Aircraft Type
Field Name
aircrafttype
Description
FAA or ICAO aircraft type code
Summary
ATC Ident
Field Name
atcident
Description
Identifier used for ATC, if it differs from flight identifier
Summary
Baggage Claim
Field Name
baggage_claim
Description
The carousel at which the baggage will or has arrived at the destination airport (requires extended flight info permission).
Summary
Cruising altitude
Field Name
cruise_alt
Description
In feet (MSL). Emitted after a flight's departure and indicates the expected cruising altitude for that flight.
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair. May be missing if not known.
Summary
Estimated In
Field Name
estimated_in
Description
The estimated in (gate arrival) time (POSIX epoch format / requires extended flight info permission).
Summary
Estimated Departure Time
Field Name
estimated_off
Description
Revised timestamp of when the flight is expected to depart (POSIX epoch format).
Summary
Estimated Arrival Time
Field Name
estimated_on
Description
Time the aircraft is estimated to touch down at the airport (POSIX epoch format).
Summary
Estimated Out
Field Name
estimated_out
Description
The estimated out (gate departure) time (POSIX epoch format / requires extended flight info permission).
Summary
En route Time
Field Name
ete
Description
In seconds. May be missing if not known.
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Filed cruising airspeed
Field Name
filed_airspeed
Description
In knots
Summary
Filed Cruising altitude
Field Name
filed_alt
Description
In feet (MSL). Emitted before a flight's departure and indicates the filed cruising altitude for that flight.
Summary
Filed En route Time
Field Name
filed_ete
Description
In seconds. May be missing if not known.
Summary
Fuel on Board
Field Name
fuel_on_board
Description
The amount of fuel in the tank. The units are reported in the fuel_on_board_unit field. This data is available for specifically authorized customers only. (version 30.0+)
Summary
Fuel on Board Unit
Field Name
fuel_on_board_unit
Description
The unit for fuel_on_board. Can be LITERS, GALLONS, POUNDS, KILOGRAMS, or UNKNOWN. This data is available for specifically authorized customers only. (version 30.0+)
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Mainline Ident
Field Name
mainline_ident
Description
The identifier used by the mainline operator that markets the flight when flown by a regional operator. If not operated by a regional operator this field is not present. (requires extended flight info permission).
Summary
Marketing Codeshares
Field Name
marketing_codeshares
Description
Identifiers used by other carriers that may market the flight segment (requires extended flight info permission).
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Top Predicted Arrival Runways
Field Name
predicted_arrival_runways
Description
The top predicted runways for the aircraft to arrive on and the predicted probability of each runway in percent decimal form. Generally only top 3 runways, unless there is an equal likelihood for multiple runways. (Ex 20 percent likelihood = 0.20). (Firehose version 27.0+, requires predicted data permissions)
Summary
Predicted In
Field Name
predicted_in
Description
Foresight predicted IN (gate arrival) time. Is dependent upon predicted ON value. Modeling starts after actual OFF event. (POSIX epoch format. Requires Foresight IN Prediction and Extended Flight Info account permissions).
Summary
Predicted Off
Field Name
predicted_off
Description
Foresight predicted OFF (runway departure) time. (POSIX epoch format. Requires Foresight Prediction and Extended Flight Info permissions).
Summary
Predicted On
Field Name
predicted_on
Description
Foresight predicted ON (runway arrival) time. ON prediction modeling starts shortly after actual OFF event. (POSIX epoch format. Requires Foresight ON Prediction and Extended Flight Info permissions).
Summary
Predicted Out
Field Name
predicted_out
Description
Foresight predicted OUT (gate departure) time. Currently not populated.
Summary
Predicted Taxi Out Duration
Field Name
predicted_taxi_out_duration
Description
Foresight predicted duration for taxi out, in seconds. Prediction modeling starts 3 hours prior to scheduled departure and continues until actual OFF event. (Requires Foresight Taxi Out Prediction permissions.)
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
Text route
Field Name
route
Description
Textual route string
Summary
Scheduled Arrival Gate
Field Name
scheduled_arrival_gate
Description
The gate at which the plane is scheduled to arrive (requires extended flight info permission).
Summary
Scheduled Arrival Terminal
Field Name
scheduled_arrival_terminal
Description
The terminal at which the plane is scheduled to arrive (requires extended flight info permission).
Summary
Scheduled Departure Gate
Field Name
scheduled_departure_gate
Description
The gate from which the plane is scheduled to depart (requires extended flight info permission).
Summary
Scheduled Departure Terminal
Field Name
scheduled_departure_terminal
Description
The terminal at which the plane is scheduled to depart (requires extended flight info permission).
Summary
Scheduled In
Field Name
scheduled_in
Description
The scheduled in (gate arrival) time. (POSIX epoch format / requires extended flight info permission).
Summary
Filed Departure Time
Field Name
scheduled_off
Description
Timestamp that was originally listed in the filed flight plan for the departure (POSIX epoch format).
Summary
Filed Arrival Time
Field Name
scheduled_on
Description
Computed from the filed departure time and time enroute (POSIX epoch format).
Summary
Scheduled Out
Field Name
scheduled_out
Description
The scheduled out (gate departure) time (POSIX epoch format / requires extended flight info permission).
Summary
Flight Status
Field Name
status
Description
Single letter code for current flight status, can be S Scheduled, F Filed, A Active, Z Completed, or X Cancelled.
Summary
True Cancellation
Field Name
trueCancel
Description
Set to 1 when a confirmed flight cancellation was received from the airline. A value of 0 or lack of this field means that this is a presumed cancellation due to expiration or lack of data.
Summary
Waypoints
Field Name
waypoints
Description
2D, 3D, or 4D objects of locations, times, and altitudes formatted as a JSON array
Flightplan an obsolete message type, available only to legacy Firehose customers under contract from 2020 or earlier. All Flightplan updates (new or modified flightplans) are now included in the `flifo` message. (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
Filed Departure Time
Field Name
fdt
Description
Timestamp that was originally listed in the filed flight plan for the departure. POSIX epoch format
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Flight Status
Field Name
status
Description
Single letter code for current flight status, can be S Scheduled, F Filed, A Active, Z Completed, or X Cancelled.
Summary
Message type
Field Name
type
Description
Value is always flightplan
Optional Fields
Summary
Field Name
Description
Summary
Aircraft Type
Field Name
aircrafttype
Description
FAA or ICAO aircraft type code
Summary
Cruising altitude
Field Name
alt
Description
In feet (MSL). For flightplan messages occurring before the actual departure, this field will typically represent the filed initial cruising altitude in the flight plan. After departure, subsequent flightplan messages may contain an updated value in this field that reflects ATC approval of additional altitude clearances.
Summary
ATC Ident
Field Name
atcident
Description
Identifier used for ATC, if it differs from flight identifier
Summary
Predicted ETA
Field Name
computed_eta
Description
Timestamp of when the flight is predicted to arrive (If enabled for the account). POSIX epoch format. (Version 11.0-17.0, replaced by predicted_on in version 18.0)
Summary
Predicted ETA Computational Method
Field Name
computed_eta_source
Description
Prediction method used for Predicted ETA. Emitted if feature enabled for the account. (Version 11.0-17.0, removed in version 18.0)
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair. May be missing if not known.
Summary
Estimated Departure Time
Field Name
edt
Description
Revised timestamp of when the flight is expected to depart. POSIX epoch format
Summary
Estimated Arrival Time
Field Name
eta
Description
POSIX epoch format
Summary
En route Time
Field Name
ete
Description
In seconds. May be missing if not known.
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Groundspeed
Field Name
gs
Description
In knots
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Latitude
Field Name
lat
Description
In decimal degrees
Summary
Longitude
Field Name
lon
Description
In decimal degrees
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Predicted Off
Field Name
predicted_off
Description
The predicted off (runway departure) time, if enabled for the account. (POSIX epoch format, Firehose version 18.0+)
Summary
Predicted On
Field Name
predicted_on
Description
The predicted in (runway arrival) time, if enabled for the account. (POSIX epoch format, Firehose version 18.0+)
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
Text route
Field Name
route
Description
Textual route string
Summary
Filed cruising speed
Field Name
speed
Description
In knots
Summary
True Cancellation
Field Name
trueCancel
Description
Set to 1 when a confirmed flight cancellation was received from the airline. A value of 0 or lack of this field means that this is a presumed cancellation due to expiration or lack of data. (version 10.0+)
Summary
Waypoints
Field Name
waypoints
Description
2D, 3D, or 4D objects of locations, times, and altitudes formatted as a JSON array
Mandatory Fields
Summary
Field Name
Description
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal.
Summary
Latitude
Field Name
lat
Description
Latitude position value (decimal degrees) of the aircraft when the report was given
Summary
Longitude
Field Name
lon
Description
Longitude position value (decimal degrees) of the aircraft when the report was given
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always fmswx
Optional Fields
Summary
Field Name
Description
Summary
Altitude
Field Name
alt
Description
Uncorrected pressure altitude reported by the aircraft in feet.
Summary
GNSS Altitude
Field Name
alt_gnss
Description
Reported GNSS altitude (feet above WGS84 ellipsoid)
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Groundspeed
Field Name
gs
Description
The groundspeed of the aircraft, reported in knots.
Summary
Heading
Field Name
heading
Description
The direction of the aircraft's ground track, in degrees, relative to true north.
Summary
Magnetic Heading
Field Name
heading_magnetic
Description
The aircraft's heading, in degrees, relative to magnetic north.
Summary
True Heading
Field Name
heading_true
Description
The aircraft's heading, in degrees, relative to true north.
Summary
Mach Number
Field Name
mach
Description
The mach number of the aircraft.
Summary
Derived from Multilateration
Field Name
mlat
Description
If this value is present and non-zero, the position was derived from multilateration, not ADS-B, therefore the lat/lon may be less accurate.
Summary
Computed Static Air Pressure
Field Name
pressure
Description
The computed static air pressure, given in hPa.
Summary
Roll Angle
Field Name
roll
Description
The roll angle of the aircraft, in degrees. A positive value indicates the right wing is down.
Summary
Airspeed
Field Name
speed_tas
Description
The true airspeed of the aircraft, reported in knots.
Summary
Computed Outside Air Temperature
Field Name
temperature
Description
The computed outside air temperature, given in degrees Celsius.
Summary
Temperature Quality
Field Name
temperature_quality
Description
The value is 0 if the derived temperature is likely to be inaccurate due to quantization errors, 1 otherwise.
Summary
Track Rate
Field Name
track_rate
Description
The rate of change of the ground track, given in degrees per second.
Summary
Vertical Rate
Field Name
vertRate
Description
The aircraft's vertical rate of climb/descent derived from pressure altitude, reported in feet per minute.
Summary
Geometric Vertical Rate
Field Name
vertRate_geom
Description
The aircraft's vertical rate of climb/descent derived from GNSS altitude, reported in feet per minute.
Summary
Computed Wind Direction
Field Name
wind_dir
Description
The computed wind direction, in degrees, relative to true north. The value uses the normal convention where the direction is opposite the wind vector (i.e. wind_dir = 0 means wind from the north).
Summary
Wind Quality
Field Name
wind_quality
Description
The value is 1 if the aircraft is stable (not maneuvering) and 0 if the aircraft is maneuvering. Derived wind data is less reliable if the aircraft is maneuvering.
Summary
Computed Wind Speed
Field Name
wind_speed
Description
The computed wind speed, given in knots.
Mandatory Fields
Summary
Field Name
Description
Summary
Airport
Field Name
airport
Description
The ICAO code of the airport the position is associated with.
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration. May sometimes be "Unknown-XXXXX" if not known.
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always ground_position
Optional Fields
Summary
Field Name
Description
Summary
ADS-B Version
Field Name
adsb_version
Description
ADS-B version used by transmitter responsible for position, when known/applicable
Summary
Air/Ground
Field Name
air_ground
Description
Air/Ground or Weight-on-Wheel (WOW) switch... "A" air, "G" ground. (Will typically be "G" for ground_positions, but switch confusion may sometimes indicate otherwise.)
Summary
Aircraft Equipment Type
Field Name
aircrafttype
Description
ICAO aircraft type code, as determined from registration information looked up using the transponder's hexid.
Summary
Airport Location
Field Name
airport_location
Description
Aircraft position if within a defined location boundary (such as "Atlantic Aviation", "Signature Flight Support (West)", "Customs Ramp"). Deprecated and replaced by "airport_locations" in version 19
Summary
Airport Location Id
Field Name
airport_location_id
Description
A consistent and unique obfuscated identifier string for each location. Deprecated and replaced by "airport_locations" in version 19
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Altitude
Field Name
alt
Description
In feet (MSL). Will generally be very close to airport surface elevation.
Summary
Altitude Source
Field Name
altSource
Description
is "FL" if the altitude source variable was derived from flightLevel reported by ASDE-X.
Summary
Arrival
Field Name
arrival
Description
Set as 1 only when an ASDE-X ground status of "arrival" is received in the upstream message
Summary
Barometric Pressure Altitude
Field Name
baroAlt
Description
Most recent barometric pressure altitude reported by the aircraft (uncorrected). 204775 means >= 204775
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfuscated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Fix
Field Name
fix
Description
For departing flights will generally be first three characters of the departure fix, or the ICAO four-letter airport name for arrival flights
Summary
Groundspeed
Field Name
gs
Description
In knots
Summary
Course
Field Name
heading
Description
In degrees
Summary
Magnetic Heading
Field Name
heading_magnetic
Description
The aircraft's heading, in degrees, relative to magnetic north.
Summary
True Heading
Field Name
heading_true
Description
The aircraft's heading, in degrees, relative to true north.
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Surface ID
Field Name
id
Description
Each discernible track will have a FlightAware-created unique track ID that will last from the time the target is first seen until a period of time has elapsed without receiving any new positions for or from the target, currently ten minutes.
Summary
Geospatial Layer
Field Name
layer
Description
If not present or empty, aircraft is within the airport boundary. If set to near, aircraft is within 5 miles of the airport center point, at a groundspeed over 100knots and at an altitude less than or equal to 5000 feet above the airport's published elevation
Summary
Mach Number
Field Name
mach
Description
The mach number of the aircraft.
Summary
Aircraft Equipment Type
Field Name
manual_aircrafttype
Description
ICAO aircraft type code, as manually entered by ATC. Sometimes "VEH" for vehicles.
Summary
NACp
Field Name
nac_p
Description
ADS-B Navigational Accuracy Category for Position
Summary
NACv
Field Name
nac_v
Description
ADS-B Navigational Accuracy Category for Velocity
Summary
NIC
Field Name
nic
Description
ADS-B Navigation Integrity Category
Summary
NIC Baro
Field Name
nic_baro
Description
ADS-B Navigation Integrity Category for Baro
Summary
On Runway
Field Name
on_runway
Description
If aircraft is on a runway, populated with the runway identifier
Summary
On Ground
Field Name
onground
Description
Set as 1 only when an ASDE-X ground status of "onground" is received in the upstream message
Summary
Radius of Containment
Field Name
pos_rc
Description
ADS-B Radius of Containment, in meters
Summary
Computed Static Air Pressure
Field Name
pressure
Description
The computed static air pressure, given in hPa.
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
scratchpad
Field Name
scratchpad1
Description
controller-entered scratchpad entries
Summary
scratchpad
Field Name
scratchpad2
Description
controller-entered scratchpad entries
Summary
SIL
Field Name
sil
Description
ADS-B Source Integrity Level
Summary
SIL Type
Field Name
sil_type
Description
ADS-B Source Integrity Level type (applies per-hour or per-sample)
Summary
Indicated Airspeed
Field Name
speed_ias
Description
The indicated airspeed of the aircraft, reported in knots.
Summary
True Airspeed
Field Name
speed_tas
Description
The true airspeed of the aircraft, reported in knots.
Summary
Transponder squawk code
Field Name
squawk
Description
4 digit octal transponder beacon code assigned by ATC
Summary
Computed Outside Air Temperature
Field Name
temperature
Description
The computed outside air temperature, given in degrees Celsius.
Summary
Temperature Quality
Field Name
temperature_quality
Description
The value is 0 if the derived temperature is likely to be inaccurate due to quantization errors, 0 otherwise.
Summary
Track Identifier
Field Name
track
Description
For ASDE-X, a track ID that should be temporally unique to this track but can roll over or restart.
Summary
Update Type
Field Name
updateType
Description
Specifies source of message, A for ADS-B, X for ASDE-X, Z for radar
Summary
Vertical Rate
Field Name
vertRate
Description
In feet per minute. number is positive if ascending; negative if descending
Summary
Computed Wind Direction
Field Name
wind_dir
Description
The computed wind direction, in degrees, relative to true north. The value uses the normal convention where the direction is opposite the wind vector (i.e. wind_dir = 0 means wind from the north).
Summary
Wind Quality
Field Name
wind_quality
Description
The value is 1 if the aircraft is stable (not maneuvering) and 0 if the aircraft is maneuvering. Derived wind data is less reliable if the aircraft is maneuvering.
Summary
Computed Wind Speed
Field Name
wind_speed
Description
The computed wind speed, given in knots.
Ground_position_unmatched A surface movement position for which the hexid or ident of the vehicle is unknown, and therefore not categorized as a regular ground_position (Schema)
Feed Type: Surface
Mandatory Fields
Summary
Field Name
Description
Summary
Airport
Field Name
airport
Description
The ICAO code of the airport the position is associated with.
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
Surface ID
Field Name
id
Description
Each discernible track will have a FlightAware-created unique track ID that will last from the time the target is first seen until a period of time has elapsed without receiving any new positions for or from the target, currently ten minutes.
Summary
Flight Identifier
Field Name
ident
Description
Opaque placeholder with display format "Unknown-XXXXX" since ident is unmatched/unknown
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always ground_position_unmatched
Optional Fields
Summary
Field Name
Description
Summary
ADS-B Version
Field Name
adsb_version
Description
ADS-B version used by transmitter responsible for position, when known/applicable
Summary
Air/Ground
Field Name
air_ground
Description
Air/Ground or Weight-on-Wheel (WOW) switch... "A" air, "G" ground. (Will typically be "G" for ground_position_unmatched, but switch confusion may sometimes indicate otherwise.)
Summary
Aircraft Equipment Type
Field Name
aircrafttype
Description
ICAO aircraft type code, as determined from registration information looked up using the transponder's hexid.
Summary
Airport Location
Field Name
airport_location
Description
Aircraft position if within a defined location boundary (such as "Atlantic Aviation", "Signature Flight Support (West)", "Customs Ramp"). Deprecated and replaced by "airport_locations" in version 19
Summary
Airport Location Id
Field Name
airport_location_id
Description
A consistent and unique obfuscated identifier string for each location. Deprecated and replaced by "airport_locations" in version 19
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Altitude
Field Name
alt
Description
In feet (MSL). Will generally be very close to airport surface elevation.
Summary
Altitude Source
Field Name
altSource
Description
is "FL" if the altitude source variable was derived from flightLevel reported by ASDE-X.
Summary
Arrival
Field Name
arrival
Description
Set as 1 only when an ASDE-X ground status of "arrival" is received in the upstream message
Summary
Barometric Pressure Altitude
Field Name
baroAlt
Description
Most recent barometric pressure altitude reported by the aircraft (uncorrected). 204775 means >= 204775
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfuscated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Fix
Field Name
fix
Description
For departing flights will generally be first three characters of the departure fix, or the ICAO four-letter airport name for arrival flights
Summary
Groundspeed
Field Name
gs
Description
In knots
Summary
Course
Field Name
heading
Description
In degrees
Summary
Magnetic Heading
Field Name
heading_magnetic
Description
The aircraft's heading, in degrees, relative to magnetic north.
Summary
True Heading
Field Name
heading_true
Description
The aircraft's heading, in degrees, relative to true north.
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Geospatial Layer
Field Name
layer
Description
If not present or empty, aircraft is within the airport boundary. If set to near, aircraft is within 5 miles of the airport center point, at a groundspeed over 100knots and at an altitude less than or equal to 5000 feet above the airport's published elevation
Summary
Mach Number
Field Name
mach
Description
The mach number of the aircraft.
Summary
Aircraft Equipment Type
Field Name
manual_aircrafttype
Description
ICAO aircraft type code, as manually entered by ATC. Sometimes "VEH" for vehicles.
Summary
NACp
Field Name
nac_p
Description
ADS-B Navigational Accuracy Category for Position
Summary
NACv
Field Name
nac_v
Description
ADS-B Navigational Accuracy Category for Velocity
Summary
NIC
Field Name
nic
Description
ADS-B Navigation Integrity Category
Summary
NIC Baro
Field Name
nic_baro
Description
ADS-B Navigation Integrity Category for Baro
Summary
On Runway
Field Name
on_runway
Description
If aircraft is on a runway, populated with the runway identifier
Summary
On Ground
Field Name
onground
Description
Set as 1 only when an ASDE-X ground status of "onground" is received in the upstream message
Summary
Radius of Containment
Field Name
pos_rc
Description
ADS-B Radius of Containment, in meters
Summary
Computed Static Air Pressure
Field Name
pressure
Description
The computed static air pressure, given in hPa.
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
scratchpad
Field Name
scratchpad1
Description
controller-entered scratchpad entries
Summary
scratchpad
Field Name
scratchpad2
Description
controller-entered scratchpad entries
Summary
SIL
Field Name
sil
Description
ADS-B Source Integrity Level
Summary
SIL Type
Field Name
sil_type
Description
ADS-B Source Integrity Level type (applies per-hour or per-sample)
Summary
Indicated Airspeed
Field Name
speed_ias
Description
The indicated airspeed of the aircraft, reported in knots.
Summary
True Airspeed
Field Name
speed_tas
Description
The true airspeed of the aircraft, reported in knots.
Summary
Transponder squawk code
Field Name
squawk
Description
4 digit octal transponder beacon code assigned by ATC
Summary
Computed Outside Air Temperature
Field Name
temperature
Description
The computed outside air temperature, given in degrees Celsius.
Summary
Temperature Quality
Field Name
temperature_quality
Description
The value is 0 if the derived temperature is likely to be inaccurate due to quantization errors, 0 otherwise.
Summary
Track Identifier
Field Name
track
Description
For ASDE-X, a track ID that should be temporally unique to this track but can roll over or restart.
Summary
Update Type
Field Name
updateType
Description
Specifies source of message, A for ADS-B, X for ASDE-X, Z for radar
Summary
Vertical Rate
Field Name
vertRate
Description
In feet per minute. number is positive if ascending; negative if descending
Summary
Computed Wind Direction
Field Name
wind_dir
Description
The computed wind direction, in degrees, relative to true north. The value uses the normal convention where the direction is opposite the wind vector (i.e. wind_dir = 0 means wind from the north).
Summary
Wind Quality
Field Name
wind_quality
Description
The value is 1 if the aircraft is stable (not maneuvering) and 0 if the aircraft is maneuvering. Derived wind data is less reliable if the aircraft is maneuvering.
Summary
Computed Wind Speed
Field Name
wind_speed
Description
The computed wind speed, given in knots.
Hold_entry This message type is emitted when we detect a flight has entered a holding pattern. (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
Hold Start Time
Field Name
hold_start
Description
Time at which the hold event start was recorded. Fixed value. In the case of multiple holds the id and hold_start can be used as a composite unique key. POSIX epoch format.
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Latitude
Field Name
lat
Description
latitude of where the aircraft entered the holding pattern in decimal degrees
Summary
Longitude
Field Name
lon
Description
longitude of where the aircraft entered the holding pattern in decimal degrees
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always hold_entry
Optional Fields
Summary
Field Name
Description
Summary
Hold Turn Degrees
Field Name
degrees
Description
The net degrees value of turns made for this hold since the first detector was launched. Positive values are clockwise, negative values are counter-clockwise.
Summary
Hold Duration
Field Name
duration
Description
Total hold duration time in seconds as of message time
Summary
Hold Laps
Field Name
laps
Description
Number of laps completed at message time
Hold_exit This message type is emitted when we detect a flight has exited a holding pattern. (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
Hold End Time
Field Name
hold_end
Description
Time at which the hold event end was recorded. POSIX epoch format.
Summary
Hold Start Time
Field Name
hold_start
Description
Time at which the hold event start was recorded. Fixed value. In the case of multiple holds the id and hold_start can be used as a composite unique key. POSIX epoch format.
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Latitude
Field Name
lat
Description
latitude of where the aircraft exited the hold in decimal degrees
Summary
Longitude
Field Name
lon
Description
longitude of where the aircraft exited the hold in decimal degrees
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always hold_exit
Optional Fields
Summary
Field Name
Description
Summary
Average Hold Altitude
Field Name
avg_alt
Description
Average altitude throughout the maneuver (in hundreds of feet)
Summary
Hold Turn Degrees
Field Name
degrees
Description
The net degrees value of turns made for this hold since the first detector was launched. Positive values are clockwise, negative values are counter-clockwise.
Summary
Hold Duration
Field Name
duration
Description
Total hold duration time in seconds as of message time
Summary
Hold End Reason
Field Name
end_reason
Description
Enumerated reason code for hold_exit - changed_direction, arrival, timeout, duration, and flying_straight
Summary
Hold Laps
Field Name
laps
Description
Number of laps completed at message time
Summary
Net Hold Distance
Field Name
net_distance
Description
Great circle net distance from the start of the event to the end of the event (miles)
Summary
Total Hold Distance
Field Name
total_distance
Description
Total distance flown from the start of the event to the end of the event (miles)
Keepalive periodic heartbeat message generated at a specific interval (Schema)
Feed Type: Any
Mandatory Fields
Summary
Field Name
Description
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Server Time
Field Name
serverTime
Description
POSIX epoch format. Current system time on the firehose server when the keepalive message was generated
Summary
Message type
Field Name
type
Description
Value is always keepalive
Location_entry a surface movement position report upon entering a pre-defined polygon (Schema)
Feed Type: Surface
Mandatory Fields
Summary
Field Name
Description
Summary
Airport
Field Name
airport
Description
The ICAO code of the airport the position is associated with.
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration. May sometimes be "Unknown-XXXXX" if not known.
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always location_entry
Optional Fields
Summary
Field Name
Description
Summary
Aircraft Equipment Type
Field Name
aircrafttype
Description
ICAO aircraft type code, as determined from registration information looked up using the transponder's hexid.
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Surface ID
Field Name
id
Description
Each discernible track will have a FlightAware-created unique track ID that will last from the time the target is first seen until a period of time has elapsed without receiving any new positions for or from the target, currently ten minutes.
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Location_exit a surface movement position report upon exiting a pre-defined polygon (Schema)
Feed Type: Surface
Mandatory Fields
Summary
Field Name
Description
Summary
Airport
Field Name
airport
Description
The ICAO code of the airport the position is associated with.
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration. May sometimes be "Unknown-XXXXX" if not known.
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always location_exit
Optional Fields
Summary
Field Name
Description
Summary
Aircraft Equipment Type
Field Name
aircrafttype
Description
ICAO aircraft type code, as determined from registration information looked up using the transponder's hexid.
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Surface ID
Field Name
id
Description
Each discernible track will have a FlightAware-created unique track ID that will last from the time the target is first seen until a period of time has elapsed without receiving any new positions for or from the target, currently ten minutes.
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Near_surface_position a position report for aircraft operating within 5000ft agl and 5 mile radius of a supported arrival/departure airport (Schema)
Feed Type: Surface
Mandatory Fields
Summary
Field Name
Description
Summary
Airport
Field Name
airport
Description
The ICAO code of the airport the position is associated with.
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration. May sometimes be "Unknown-XXXXX" if not known.
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always near_surface_position
Optional Fields
Summary
Field Name
Description
Summary
ADS-B Version
Field Name
adsb_version
Description
ADS-B version used by transmitter responsible for position, when known/applicable
Summary
Air/Ground
Field Name
air_ground
Description
Air/Ground or Weight-on-Wheel (WOW) switch... "A" air, "G" ground. (Will typically be "G" for near_surface_positions, but switch confusion may sometimes indicate otherwise.)
Summary
Aircraft Equipment Type
Field Name
aircrafttype
Description
ICAO aircraft type code, as determined from registration information looked up using the transponder's hexid.
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Altitude
Field Name
alt
Description
In feet (MSL). Will generally be very close to airport surface elevation.
Summary
Altitude Source
Field Name
altSource
Description
is "FL" if the altitude source variable was derived from flightLevel reported by ASDE-X.
Summary
Arrival
Field Name
arrival
Description
Set as 1 only when an ASDE-X ground status of "arrival" is received in the upstream message
Summary
Barometric Pressure Altitude
Field Name
baroAlt
Description
Most recent barometric pressure altitude reported by the aircraft (uncorrected). 204775 means >= 204775
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfuscated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Fix
Field Name
fix
Description
For departing flights will generally be first three characters of the departure fix, or the ICAO four-letter airport name for arrival flights
Summary
Groundspeed
Field Name
gs
Description
In knots
Summary
Course
Field Name
heading
Description
In degrees
Summary
Magnetic Heading
Field Name
heading_magnetic
Description
The aircraft's heading, in degrees, relative to magnetic north.
Summary
True Heading
Field Name
heading_true
Description
The aircraft's heading, in degrees, relative to true north.
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Surface ID
Field Name
id
Description
Each discernible track will have a FlightAware-created unique track ID that will last from the time the target is first seen until a period of time has elapsed without receiving any new positions for or from the target, currently ten minutes.
Summary
Geospatial Layer
Field Name
layer
Description
If not present or empty, aircraft is within the airport boundary. If set to near, aircraft is within 5 miles of the airport center point, at a groundspeed over 100knots and at an altitude less than or equal to 5000 feet above the airport's published elevation
Summary
Mach Number
Field Name
mach
Description
The mach number of the aircraft.
Summary
Aircraft Equipment Type
Field Name
manual_aircrafttype
Description
ICAO aircraft type code, as manually entered by ATC. Sometimes "VEH" for vehicles.
Summary
NACp
Field Name
nac_p
Description
ADS-B Navigational Accuracy Category for Position
Summary
NACv
Field Name
nac_v
Description
ADS-B Navigational Accuracy Category for Velocity
Summary
NIC
Field Name
nic
Description
ADS-B Navigation Integrity Category
Summary
NIC Baro
Field Name
nic_baro
Description
ADS-B Navigation Integrity Category for Baro
Summary
On Runway
Field Name
on_runway
Description
If aircraft is on a runway, populated with the runway identifier
Summary
On Ground
Field Name
onground
Description
Set as 1 only when an ASDE-X ground status of "onground" is received in the upstream message
Summary
Radius of Containment
Field Name
pos_rc
Description
ADS-B Radius of Containment, in meters
Summary
Computed Static Air Pressure
Field Name
pressure
Description
The computed static air pressure, given in hPa.
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
scratchpad
Field Name
scratchpad1
Description
controller-entered scratchpad entries
Summary
scratchpad
Field Name
scratchpad2
Description
controller-entered scratchpad entries
Summary
SIL
Field Name
sil
Description
ADS-B Source Integrity Level
Summary
SIL Type
Field Name
sil_type
Description
ADS-B Source Integrity Level type (applies per-hour or per-sample)
Summary
Indicated Airspeed
Field Name
speed_ias
Description
The indicated airspeed of the aircraft, reported in knots.
Summary
True Airspeed
Field Name
speed_tas
Description
The true airspeed of the aircraft, reported in knots.
Summary
Transponder squawk code
Field Name
squawk
Description
4 digit octal transponder beacon code assigned by ATC
Summary
Computed Outside Air Temperature
Field Name
temperature
Description
The computed outside air temperature, given in degrees Celsius.
Summary
Temperature Quality
Field Name
temperature_quality
Description
The value is 0 if the derived temperature is likely to be inaccurate due to quantization errors, 0 otherwise.
Summary
Track Identifier
Field Name
track
Description
For ASDE-X, a track ID that should be temporally unique to this track but can roll over or restart.
Summary
Update Type
Field Name
updateType
Description
Specifies source of message, A for ADS-B, X for ASDE-X, Z for radar
Summary
Vertical Rate
Field Name
vertRate
Description
In feet per minute. number is positive if ascending; negative if descending
Summary
Computed Wind Direction
Field Name
wind_dir
Description
The computed wind direction, in degrees, relative to true north. The value uses the normal convention where the direction is opposite the wind vector (i.e. wind_dir = 0 means wind from the north).
Summary
Wind Quality
Field Name
wind_quality
Description
The value is 1 if the aircraft is stable (not maneuvering) and 0 if the aircraft is maneuvering. Derived wind data is less reliable if the aircraft is maneuvering.
Summary
Computed Wind Speed
Field Name
wind_speed
Description
The computed wind speed, given in knots.
Surface_Offblock indicates a flight has departed the gate (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always surface_offblock
Optional Fields
Summary
Field Name
Description
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair. May be missing if not known.
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Surface_Onblock indicates a flight has arrived at the gate (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always surface_onblock
Optional Fields
Summary
Field Name
Description
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair. May be missing if not known.
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Power_on indicates the detection of the first message from an aircraft, typically corresponding with initial powering of the avionics on the ground at the origin airport (Schema)
Feed Type: Airborne
Mandatory Fields
Summary
Field Name
Description
Summary
Airport
Field Name
airport
Description
Location where the event was detected. ICAO airport code, waypoint, or latitude/longitude pair
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
FlightAware flight id
Field Name
id
Description
Unique identifier associated with each flight (faFlightID)
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always power_on
Optional Fields
Summary
Field Name
Description
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair. May be missing if not known.
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair. May be missing if not known.
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Mandatory Fields
Summary
Field Name
Description
Summary
Air/Ground
Field Name
air_ground
Description
Air/Ground or Weight-on-Wheel (WOW) switch... "A" air, "G" ground
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfusticated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
FlightAware flight id
Field Name
id
Description
FlightAware flight id
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration.
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always position
Summary
Update Type
Field Name
updateType
Description
Specifies source of message, A for ADS-B, Z for radar, O for transoceanic, P for estimated, D for datalink, M for Multilateration (MLAT), X for ASDE-X, S for Space-based ADS-B
Optional Fields
Summary
Field Name
Description
Summary
ADS-B Version
Field Name
adsb_version
Description
ADS-B version used by transmitter responsible for position, when known/applicable
Summary
Aircraft Type
Field Name
aircrafttype
Description
ICAO aircraft type code
Summary
Altitude
Field Name
alt
Description
In feet (MSL)
Summary
GNSS Altitude
Field Name
alt_gnss
Description
Reported GNSS altitude (feet above WGS84 ellipsoid) (version 21.0+)
Summary
Altitude Change
Field Name
altChange
Description
"C" for climbing, "D" for descending, " " when undetermined
Summary
ATC Ident
Field Name
atcident
Description
Identifier used for ATC, if it differs from flight identifier
Summary
Destination
Field Name
dest
Description
ICAO airport code, waypoint, or latitude/longitude pair. May be missing if not known.
Summary
Estimated Departure Time
Field Name
edt
Description
Revised timestamp of when the flight is expected to depart. POSIX epoch format
Summary
ETA
Field Name
eta
Description
Estimated Time of Arrival. POSIX epoch format
Summary
En route Time
Field Name
ete
Description
In seconds. May be missing if not known.
Summary
Fuel on Board
Field Name
fuel_on_board
Description
The amount of fuel in the tank. The units are reported in the fuel_on_board_unit field. This data is available for specifically authorized customers only. (version 30.0+)
Summary
Fuel on Board Unit
Field Name
fuel_on_board_unit
Description
The unit for fuel_on_board. Can be LITERS, GALLONS, POUNDS, KILOGRAMS or UNKNOWN. This data is available for specifically authorized customers only. (version 30.0+)
Summary
Groundspeed
Field Name
gs
Description
In knots
Summary
Course
Field Name
heading
Description
In degrees
Summary
Magnetic Heading
Field Name
heading_magnetic
Description
The aircraft's heading, in degrees, relative to magnetic north.
Summary
True Heading
Field Name
heading_true
Description
The aircraft's heading, in degrees, relative to true north.
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Mach Number
Field Name
mach
Description
The mach number of the aircraft.
Summary
NACp
Field Name
nac_p
Description
ADS-B Navigational Accuracy Category for Position
Summary
NACv
Field Name
nac_v
Description
ADS-B Navigational Accuracy Category for Velocity
Summary
Navigation Altitude
Field Name
nav_altitude
Description
The altitude setting, in feet, from the navigation equipment.
Summary
Navigation Heading
Field Name
nav_heading
Description
The heading, in degrees, from the navigation equipment.
Summary
Navigation Modes
Field Name
nav_modes
Description
The list of active modes from the navigation equipment. Possible values are autopilot, vnav, althold, approach, lnav, tcas.
Summary
Navigation Altimeter Setting
Field Name
nav_qnh
Description
The altimeter setting, in hPa, that has been set.
Summary
NIC
Field Name
nic
Description
ADS-B Navigation Integrity Category
Summary
NIC Baro
Field Name
nic_baro
Description
ADS-B Navigation Integrity Category for Barometer
Summary
Origin
Field Name
orig
Description
ICAO airport code, waypoint, or latitude/longitude pair
Summary
Radius of Containment
Field Name
pos_rc
Description
ADS-B Radius of Containment, in meters
Summary
Computed Static Air Pressure
Field Name
pressure
Description
The computed static air pressure, given in hPa.
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
Text route
Field Name
route
Description
Textual route string
Summary
SIL
Field Name
sil
Description
ADS-B Source Integrity Level
Summary
SIL Type
Field Name
sil_type
Description
ADS-B Source Integrity Level type (applies per-hour or per-sample)
Summary
Filed cruising speed
Field Name
speed
Description
In knots
Summary
Indicated Airspeed
Field Name
speed_ias
Description
The indicated airspeed of the aircraft, reported in knots.
Summary
True Airspeed
Field Name
speed_tas
Description
The true airspeed of the aircraft, reported in knots.
Summary
Transponder squawk code
Field Name
squawk
Description
4 digit octal transponder beacon code assigned by ATC
Summary
Computed Outside Air Temperature
Field Name
temperature
Description
The computed outside air temperature, given in degrees Celsius.
Summary
Temperature Quality
Field Name
temperature_quality
Description
The value is 0 if the derived temperature is likely to be inaccurate due to quantization errors, 0 otherwise.
Summary
Vertical Rate
Field Name
vertRate
Description
The aircraft's vertical rate of climb/descent derived from pressure altitude, reported in feet per minute. (version 21.0+)
Summary
Geometric Vertical Rate
Field Name
vertRate_geom
Description
The aircraft's vertical rate of climb/descent derived from GNSS altitude, reported in feet per minute. (version 21.0+)
Summary
Waypoints
Field Name
waypoints
Description
2D, 3D, or 4D objects of locations, times, and altitudes formatted as a JSON array
Summary
Computed Wind Direction
Field Name
wind_dir
Description
The computed wind direction, in degrees, relative to true north. The value uses the normal convention where the direction is opposite the wind vector (i.e. wind_dir = 0 means wind from the north).
Summary
Wind Quality
Field Name
wind_quality
Description
The value is 1 if the aircraft is stable (not maneuvering) and 0 if the aircraft is maneuvering. Derived wind data is less reliable if the aircraft is maneuvering.
Summary
Computed Wind Speed
Field Name
wind_speed
Description
The computed wind speed, given in knots.
Vehicle_position a surface movement position report from a ground vehicle (non-aircraft) (Schema)
Feed Type: Surface
Mandatory Fields
Summary
Field Name
Description
Summary
Airport
Field Name
airport
Description
The ICAO code of the airport the position is associated with.
Summary
Report Time
Field Name
clock
Description
POSIX epoch format. Time should be the time generated by flight hardware if possible
Summary
Flight Identifier
Field Name
ident
Description
Callsign identifying the flight. Typically, ICAO airline code plus IATA/ticketing flight number, or the aircraft registration. May sometimes be "Unknown-XXXXX" if not known.
Summary
Latitude
Field Name
lat
Description
In decimal degrees, rounded to 5 decimal points
Summary
Longitude
Field Name
lon
Description
In decimal degrees, rounded to 5 decimal points
Summary
Point In Time Recovery
Field Name
pitr
Description
Timestamp value that should be supplied to the "pitr" connection initiation command when reconnecting and you wish to resume firehose playback at that approximate position
Summary
Message type
Field Name
type
Description
Value is always vehicle_position
Optional Fields
Summary
Field Name
Description
Summary
Air/Ground
Field Name
air_ground
Description
Air/Ground or Weight-on-Wheel (WOW) switch... "A" air, "G" ground. (Will typically be "G" for ground_positions, but switch confusion may sometimes indicate otherwise.)
Summary
Aircraft Equipment Type
Field Name
aircrafttype
Description
ICAO aircraft type code, as determined from registration information looked up using the transponder's hexid.
Summary
Airport Location
Field Name
airport_location
Description
Aircraft position if within a defined location boundary (such as "Atlantic Aviation", "Signature Flight Support (West)", "Customs Ramp"). Deprecated and replaced by "airport_locations" in version 19.
Summary
Airport Location Id
Field Name
airport_location_id
Description
A consistent and unique obfuscated identifier string for each location. Deprecated and replaced by "airport_locations" in version 19.
Summary
Airport Location
Field Name
airport_locations
Description
Airport surface polygons formatted as an array of JSON objects
Summary
Altitude
Field Name
alt
Description
In feet (MSL). Will generally be very close to airport surface elevation.
Summary
Altitude Source
Field Name
altSource
Description
is "FL" if the altitude source variable was derived from flightLevel reported by ASDE-X.
Summary
Arrival
Field Name
arrival
Description
Set as 1 only when an ASDE-X ground status of "arrival" is received in the upstream message
Summary
Barometric Pressure Altitude
Field Name
baroAlt
Description
Most recent barometric pressure altitude reported by the aircraft (uncorrected). 204775 means >= 204775
Summary
Reporting facility hash
Field Name
facility_hash
Description
A consistent and unique obfuscated identifier string for each source reporting positions to FlightAware
Summary
Reporting facility name
Field Name
facility_name
Description
A description of the reporting facility intended for end-user consumption. May be a blank string if undefined.
Summary
Fix
Field Name
fix
Description
For departing flights will generally be first three characters of the departure fix, or the ICAO four-letter airport name for arrival flights
Summary
Groundspeed
Field Name
gs
Description
In knots
Summary
Course
Field Name
heading
Description
In degrees
Summary
Transponder Mode S code
Field Name
hexid
Description
24-bit Mode S transponder code assigned by aircraft registrar. Formatted in upper case hexadecimal
Summary
Surface ID
Field Name
id
Description
Each discernible track will have a FlightAware-created unique track ID that will last from the time the target is first seen until a period of time has elapsed without receiving any new positions for or from the target, currently ten minutes.
Summary
Geospatial Layer
Field Name
layer
Description
If not present or empty, aircraft is within the airport boundary. If set to near, aircraft is within 5 miles of the airport center point, at a groundspeed over 100knots and at an altitude less than or equal to 5000 feet above the airport's published elevation
Summary
Aircraft Equipment Type
Field Name
manual_aircrafttype
Description
ICAO aircraft type code, as manually entered by ATC. Sometimes "VEH" for vehicles.
Summary
On Runway
Field Name
on_runway
Description
If aircraft is on a runway, populated with the runway identifier
Summary
On Ground
Field Name
onground
Description
Set as 1 only when an ASDE-X ground status of "onground" is received in the upstream message
Summary
Aircraft Registration
Field Name
reg
Description
The tail number or registration of the aircraft, if known and it differs from the ident.
Summary
scratchpad
Field Name
scratchpad1
Description
controller-entered scratchpad entries
Summary
scratchpad
Field Name
scratchpad2
Description
controller-entered scratchpad entries
Summary
Transponder squawk code
Field Name
squawk
Description
4 digit octal transponder beacon code assigned by ATC
Summary
Track Identifier
Field Name
track
Description
For ASDE-X, a track ID that should be temporally unique to this track but can roll over or restart.
Summary
Update Type
Field Name
updateType
Description
Specifies source of message, A for ADS-B, X for ASDE-X, Z for radar
Summary
Vertical Rate
Field Name
vertRate
Description
In feet per minute. number is positive if ascending; negative if descending
