SKskyvexsoftware
Flights

Pilot's current bids

Changed on

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

Request

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, so 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. This is per-pilot, so another pilot's OFP does not lock it. Drives the client's dropdown-vs-text rendering.

notesstring required
logo_lightstring uri nullable

Optional. URL of the operating airline's logo for light backgrounds. Shown at the start of the booking row in the client's light theme, up to 40px tall. Omit or send null to show no logo.

logo_darkstring uri nullable

Optional. URL of the operating airline's logo for dark backgrounds. Used in the client's dark theme; falls back to logo_light when omitted or null.

Example response

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

Changes

  • 51e47958ed25Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status