Sign in

v1

latestOpenAPI 3.1.02026-07-22162733.8 KB
Flights

Pilot's current bids

Every flight the authenticated pilot has currently bid on (and not yet flown or unbid). The Stratos client renders this as the My Bookings list. If the pilots.only_flights_from_current VA setting is enabled, bookings whose departure airport is not the pilot's current location are filtered out server-side.

get/flights/bookings

Response

Array of bookings (may be empty).

bid_idinteger required

Unique bid ID. Used by /flights/start and /flights/unbook.

numberstring required

Flight number (no airline code).

codestring required

Operating airline code.

departure_airportstring required

Departure airport ID (ICAO).

arrival_airportstring required
routestring[] required

Route waypoints split on whitespace. Empty array if no route is filed.

flight_levelstring required

Cruise altitude as filed (free-form string, e.g. 360 or FL360).

distancenumber float required

Great-circle distance in the VA's configured local unit (typically nautical miles).

departure_timestring required

Scheduled departure, free-form per VA setting.

arrival_timestring required
flight_timenumber float required

Scheduled flight time in decimal hours.

days_of_weekinteger[] required

Days the flight operates (0 = Sunday). Empty if not configured.

type'P' | 'C' required

Coarse flight category derived from phpVMS's flight_type. P = passenger (scheduled/charter/extra/govt/other), C = cargo (ambulance/cargo/training/mail/military/positioning/special/general aviation/technical).

aircraftinteger nullable required

Aircraft ID assigned to the bid: the SimBrief airframe if set, otherwise the bid's aircraft. Null when no aircraft is assigned — the pilot must pick one (e.g. via /flights/change-aircraft) before starting.

aircraft_changeableboolean

Whether the pilot may switch the aircraft for this bid before starting. False when the authenticated pilot has their own SimBrief OFP for this flight — per-pilot, so another pilot's OFP does not lock it. Drives the client's dropdown-vs-text rendering.

notesstring required

Example response

[
  {
    "departure_airport": "YSSY",
    "arrival_airport": "YMML",
    "route": [
      "YSSY",
      "DCT",
      "RIC",
      "YMML"
    ],
    "departure_time": "0930",
    "arrival_time": "1145",
    "flight_time": 1.42
  }
]