Skip to main content
GET
/
flights
/
search
Error
A valid request URL is required to generate request examples
[
  {
    "id": 123,
    "number": "<string>",
    "code": "<string>",
    "departure_airport": "<string>",
    "arrival_airport": "<string>",
    "flight_level": "<string>",
    "route": "<string>",
    "distance": 123,
    "departure_time": "<string>",
    "arrival_time": "<string>",
    "flight_time": 123,
    "days_of_week": [
      123
    ],
    "aircraft": "<string>",
    "notes": "<string>"
  }
]

Authorizations

​
Authorization
string
header
required

The pilot's API key, obtained via POST /pilot/login or your OAuth flow. Send as Authorization: Bearer <api_key> on every authenticated request.

Query Parameters

​
departure_airport
string

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

Required string length: 3 - 4
​
arrival_airport
string

ICAO of the arrival airport.

Required string length: 3 - 4
​
aircraft
integer

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

​
minimum_flight_time
number<float>

Minimum scheduled flight time, in decimal hours.

Required range: x >= 0
​
maximum_flight_time
number<float>

Maximum scheduled flight time, in decimal hours.

Required range: x >= 0
​
minimum_distance
number<float>

Minimum great-circle distance in nautical miles.

Required range: x >= 0
​
maximum_distance
number<float>

Maximum great-circle distance in nautical miles.

Required range: x >= 0
​
limit
integer
default:100

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

Required range: 1 <= x <= 100

Response

Array of matching flights (may be empty).

​
id
integer
required

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

​
number
string
required
​
code
string
required
​
departure_airport
string
required
​
arrival_airport
string
required
​
flight_level
string
required
​
route
string | null
required

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

​
distance
number<float>
required
​
departure_time
string
required
​
arrival_time
string
required
​
flight_time
number<float>
required
​
days_of_week
integer[]
required

Always returned as an empty array on search results.

​
type
enum<string>
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).

Available options:
P,
C
​
aircraft
string | null
required

Display name of the first matching subfleet aircraft.

​
notes
string | null
required