v1

latestOpenAPI 3.1.02026-07-22162733.8 KB

Flights

Search the schedule

Search the VA's published schedule. Every filter is optional — an empty query returns up to limit flights. Filters are AND-combined.

If pilots.only_flights_from_current is enabled, the departure_airport filter is overridden server-side with the pilot's current airport.

get/flights/search

Query parameters

departure_airportstring

ICAO of the departure airport (e.g. YSSY).

arrival_airportstring

ICAO of the arrival airport.

aircraftinteger

Subfleet ID — only flights whose visible subfleets include this one are returned.

minimum_flight_timenumber float

Minimum scheduled flight time, in decimal hours.

maximum_flight_timenumber float

Maximum scheduled flight time, in decimal hours.

minimum_distancenumber float

Minimum great-circle distance in nautical miles.

maximum_distancenumber float

Maximum great-circle distance in nautical miles.

limitinteger

Max results to return. Capped server-side at 100.

Response

Array of matching flights (may be empty).

idinteger required

Flight ID (not a bid — convert to a bid by booking via your VA's booking flow before calling /flights/start).

numberstring required

codestring required

departure_airportstring required

arrival_airportstring required

flight_levelstring required

routestring nullable required

Route as a single space-separated string. Differs from /flights/bookings where this is split into an array.

distancenumber float required

departure_timestring required

arrival_timestring required

flight_timenumber float required

days_of_weekinteger[] required

Always returned as an empty array on search results.

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).

aircraftstring nullable required

Display name of the first matching subfleet aircraft.

notesstring nullable required