A valid request URL is required to generate request examples{}{
"error": "tracking_id is required"
}{
"success": false,
"error": "Invalid Token"
}{
"error": "PIREP not found"
}Position and phase update
Sent by the desktop client at the pilot’s chosen position-update interval (currently 15, 30, or 60 seconds) while a flight is active. Each call appends a FLIGHT_PATH point to the PIREP and updates the PIREP’s status based on the reported phase.
The reference phpVMS module reads phase case-insensitively and maps it to a PIREP status:
| Stratos phase | phpVMS status |
|---|---|
BOARDING | BOARDING |
PUSH_BACK | PUSHBACK_TOW |
TAXI / REJECTED_TAKE_OFF / TAXI_TO_GATE | TAXI |
TAKE_OFF | TAKEOFF |
CLIMB / CRUISE | ENROUTE |
DESCENT / GO_AROUND | APPROACH |
APPROACH | APPROACH_ICAO |
FINAL | LANDING |
LANDED | LANDED |
DEBOARDING | ON_BLOCK |
PAUSED | PAUSED |
UNKNOWN, or any other value | ENROUTE |
It also accepts lower-case values and the older names taxi_in, arrived, on_block, climb_out and diverted. The first update that reaches TAKEOFF, INIT_CLIM or ENROUTE sets block_off_time. The first update that reaches ON_BLOCK or ARRIVED sets block_on_time. The server’s running flight time is recomputed from the first ACARS row’s created_at each update.
Either uuid or tracking_id may carry the PIREP ID (the client uses them interchangeably).
A valid request URL is required to generate request examples{}{
"error": "tracking_id is required"
}{
"success": false,
"error": "Invalid Token"
}{
"error": "PIREP not found"
}Authorizations
The pilot's API key, obtained via POST /pilot/login or your OAuth flow. Send as Authorization: Bearer <api_key> on every authenticated request.
Body
Current flight phase as Stratos sends it, in capitals. TAXI_IN and ARRIVED are both sent as TAXI_TO_GATE, PAUSED is sent while the simulator is paused, and UNKNOWN before a phase is detected. The reference implementation reads the value case-insensitively and treats anything it doesn't know as CRUISE (PirepStatus::ENROUTE).
BOARDING, PUSH_BACK, TAXI, TAKE_OFF, REJECTED_TAKE_OFF, CLIMB, CRUISE, DESCENT, APPROACH, FINAL, LANDED, GO_AROUND, TAXI_TO_GATE, DEBOARDING, PAUSED, UNKNOWN -90 <= x <= 90-180 <= x <= 180Indicated altitude in feet.
True heading in degrees.
0 <= x <= 360PIREP ID returned by /flights/start. Use either this or tracking_id.
Synonym for uuid, supplied for backwards compatibility.
Ground speed in knots. Defaults to 0 if omitted.
Nautical miles remaining to destination. Used to compute the cumulative distance written to the FLIGHT_PATH row.
Response
Update accepted. The reference implementation returns an empty body.
The response is of type object | null.
Was this page helpful?