At a glance
- Set it on Plugins → Flight Tracking → Additional fields in Console: one row per field, one column per flight phase, and a PIREP column.
- Tick a phase to send the field on position updates during that phase; tick PIREP to send it once with the completed flight.
- Example payload shows exactly what your backend will get.
- Where PIREP fields go picks Nested (one
additional_fieldsobject, which the stock phpVMS module saves as custom PIREP fields) or Top level. - Changes apply from each pilot’s next flight.
Choose your fields
Open Plugins → Flight Tracking in Console, then the Additional fields tab.

Check what your backend gets
The Example payload button on the Additional fields tab shows the position update for your own selection, phase by phase, with your fields highlighted:

Choose where PIREP fields go
Where PIREP fields go, the Nested / Top level switch above the matrix, decides where the PIREP-ticked fields sit in the/flights/complete body:


- Nested (default for new airlines): the ticked fields, plus
simulator_version, arrive as oneadditional_fieldsobject. The stock Stratos phpVMS module writes every entry topirep_field_valuesas a custom PIREP field (source ACARS). - Top level (the original shape): each ticked field is a flat key next to the thirteen always-on completion keys. The stock Stratos phpVMS module ignores these extra keys, so use this when another module reads them or already writes custom PIREP fields for Stratos flights.
Rules worth knowing
- A field is appended on a tick only when the live phase is one you ticked for it.
- Live fields are read from the sim every tick; when the sim can’t supply a value the raw default rides along (
0,false, or""): live fields are never blank. - Milestone fields are
nulluntil their capture milestone passes; the same applies to a PIREP-ticked milestone field whose milestone never fired. block_fuelandzfwon the completion PIREP are omitted entirely (not0) when never captured.- A few live fields are aliases or derived rather than direct telemetry:
flaps_left_position/flaps_right_position(aliased toflaps_control) andcruise_altitude(current altitude rounded). The table notes call each one out. - Anything you turn on later starts appearing from the next flight onwards.
Field reference
The rest of this page is the reference: what every report always carries, then every optional field. It’s kept in step with the Stratos code: when a new field is added, it’s added here.What every report always carries
Two sets of fields are sent unconditionally, regardless of what you tick.Position update: the always-on keys
Every position update POSTed to your backend’s/flights/update opens with these eleven keys, in this order, before any optional fields are appended:
The opt-in
miles_to_go field carries the same value as distance_remaining,
which is already always present, so there is no need to enable miles_to_go
separately.Completion PIREP: the always-on keys
The completion POST to/flights/complete always includes these thirteen keys, before any PIREP-ticked fields are merged on top:
When Flight Tracking’s Ask which network pilots are flying on is on, the completion also carries
network: the network the pilot picked, as its Sent as value.
landing_rate, fuel_used, simulator_version and network (when networks
are asked for) are always included here with their authoritative completion
values, so PIREP is disabled for them in the matrix: ticking it would only override the authoritative value
with the live one, so there is nothing to add.How optional fields are delivered
Every optional field is one of two kinds. This determines what your backend receives and when:- Live: read from the simulator on every tick and sent at its current value. If the sim can’t supply it, the raw default is sent:
0for numbers,falsefor booleans,""for strings. Live fields are never blank. - Milestone: captured once when the flight passes a milestone (block-off, takeoff, touchdown, block-on) and stored in the PIREP snapshot. A milestone field appended to a position update before its capture milestone is sent as
null; the same applies to a PIREP-ticked milestone field whose milestone never fired.
Optional live fields
Grouped as they appear in the matrix in Console. The Key column is the exact key your VA backend sees in the JSON payload.Position & Navigation
Orientation
Flight Controls
Engine Data
engines_count reports how many engines the current aircraft has: use it to ignore engine3_* / engine4_* on twins. Per-engine fields exist for all four slots; on X-Plane the unused slots are masked to 0 / false.
For each engine there are two “running” signals: engineN_firing is the raw combustion flag (it can flicker on some MSFS 2024 aircraft), while engineN_on is a debounced, composite running flag that is more stable. Prefer engineN_on for “is the engine running”.
Fuel
Weather
Simulation Time
The simulator’s in-world clock, for logging what time it is in the sim rather than in the real world.Aircraft Information
Simulator State
Warnings
Exterior Lights
Read from the simulator’s own light variables, so what they mean depends on the aircraft. Some aircraft report the switch position (PMDG, X-Plane); others report whether the light is actually lit (Fenix, where strobe AUTO and gear-mounted lights follow the aircraft’s logic). Aircraft without a given light can still report it as on, so decide per aircraft which lights a rule should apply to. Runway turnoff lights have no field of their own; some aircraft report them aslight_taxi.
On X-Plane, logo, wing and runway turnoff lights are wired to “generic” lights whose numbering each aircraft developer chooses, and many airliners (the default XP11 737, the XP12 A330) don’t drive the standard taxi switch, so light_logo, light_wing, light_taxi and the numbered landing lights are null there. X-Plane reports beacon, strobe, nav and landing. A nose light in its take-off position counts as a landing light on some aircraft (XP12 A330).
The same values are available to event rules as lightBeacon, lightStrobe, lightNav, lightLogo, lightWing, lightLanding, lightTaxi and lightLanding1 to lightLanding3.
Landing Analysis
These live fields are easy to misread: most are not the held touchdown values their names suggest. For authoritative touchdown figures, use the milestonelanding_* fields below or the completion landing_report.
Navigation
Flight Session
Optional milestone fields
Captured once at a flight milestone and held for the rest of the flight. Sent asnull until their milestone passes. Group order matches the matrix in Console.
Departure
Captured at block-off (first movement / pushback).Takeoff
Captured at the takeoff trigger (airborne, post-debounce).Landing
Captured at touchdown, from the landing analyser.Arrival
Captured at touchdown or block-on (final stop before shutdown).Summary
Captured at completion.The phase fields
There are two distinct phase concepts.-
The always-on top-level
phaseon every position update. It is the UPPERCASE API phase:BOARDING,PUSH_BACK,TAXI,TAKE_OFF,REJECTED_TAKE_OFF,CLIMB,CRUISE,DESCENT,APPROACH,FINAL,LANDED,GO_AROUND,TAXI_TO_GATE(bothTAXI_INandARRIVEDcollapse to this),DEBOARDING, orUNKNOWN. While the sim is paused it reportsPAUSED. This is the onlyphasekey on the wire and it is sent on every update, so there is no separate opt-in phase field to enable. -
The 15 matrix phase columns, which decide when each field is sent. Their keys are uppercase and keep
TAXI_INandARRIVEDseparate:BOARDING,PUSH_BACK,TAXI,TAKE_OFF,REJECTED_TAKE_OFF,CLIMB,CRUISE,DESCENT,APPROACH,FINAL,LANDED,GO_AROUND,TAXI_IN,ARRIVED,DEBOARDING.UNKNOWNis never a column, andPAUSEDis never a column.
phase reads PAUSED. For the full phase model and the conditions that move a flight between phases, see Flight Phases.
Example position update
On each tick, the fields whose phase set includes the current phase are added after the eleven always-on keys. A position update duringCRUISE, with a few cruise fields ticked:
Field availability by simulator
Not every simulator populates every field. The general picture:- MSFS 2020 / 2024 / FSX / P3D (SimConnect): populate the broadest set, including all engine slots,
engineN_pct_rpm,slew_mode, and native latchedtouchdown_*live fields. - X-Plane 11 / 12 (UDP DataRef): populate the same core telemetry, but a few fields are unavailable and report their defaults:
engineN_pct_rpmis0,slew_modeisfalse,landing_rateis0in the air (it holds the canonical touchdown rate after touchdown), the zulu date aliases to the local date, andaltimeter_settingsduplicatespressure_qnh. - Touchdown / departure position (
touchdown_latitude/touchdown_longitude,departure_latitude/departure_longitude) is captured on every sim (including X-Plane) so a VA can derive the arrival and departure runways server-side where the client can’t match one. - Facility-derived milestone fields (
departure_runway,arrival_runway, the gate and runway-deviation fields) are matched client-side and are MSFS only:nullon X-Plane; use the touchdown / departure coordinates above to derive them server-side.aircraft_liveryis populated on MSFS 2024 and X-Plane but empty on MSFS 2020 / FSX / P3D.
0, false, or "" for live fields, null for uncaptured milestone fields). It won’t fabricate values.