---
title: "Search the schedule"
method: GET
path: "/flights/search"
tags: ["Flights"]
---

# Search the schedule

`GET /flights/search`

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.

## Query parameters

- `departure_airport` string
- `arrival_airport` string
- `aircraft` integer
- `minimum_flight_time` number, float
- `maximum_flight_time` number, float
- `minimum_distance` number, float
- `maximum_distance` number, float
- `limit` integer

## Response `200`

Array of matching flights (may be empty).

- FlightSearchResult[]
  - `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, nullable, 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` '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).
  - `aircraft` string, nullable, required — Display name of the first matching subfleet aircraft.
  - `notes` string, nullable, required

## Other responses

- `401` — Missing or invalid Bearer token.

---

[API](https://skmtc.net/skyvexsoftware/apis/stratos-core-api.md) · [All operations](https://skmtc.net/skyvexsoftware/apis/stratos-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/skyvexsoftware/stratos-core-api/versions/0b7ba98ff0aa/schema)