Skip to main content
GET
SearchGoogleFlights

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

origin
string

Departure airport IATA code (e.g. "JFK").

destination
string

Arrival airport IATA code (e.g. "LHR").

departure_date
string

Departure date in YYYY-MM-DD format.

return_date
string

Return date in YYYY-MM-DD format; omit for one-way.

cabin_class
string

Cabin class: ECONOMY, PREMIUM_ECONOMY, BUSINESS, or FIRST.

max_stops
string

Stop filter: ANY, NON_STOP, ONE_STOP, or TWO_PLUS_STOPS.

departure_window
string

Departure time window in HH-HH format (e.g. "6-20").

airlines
string[]

Airline IATA codes to filter by (e.g. ["BA", "AA"]).

sort_by
string

Sort order: CHEAPEST, DURATION, DEPARTURE_TIME, or ARRIVAL_TIME.

passengers
integer<int32>

Number of adult passengers (1-9).

jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

SearchGoogleFlightsResponse contains flight results from Google Flights.

flights
object[]
degraded
boolean
error
string