Skip to main content
GET
SearchGoogleDates

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

start_date
string

Start of date range in YYYY-MM-DD format.

end_date
string

End of date range in YYYY-MM-DD format.

trip_duration
integer<int32>

Trip duration in days (required for round-trip searches).

is_round_trip
boolean

Whether to search for round-trip flights.

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_price
boolean

Whether to sort results by price (lowest first).

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

SearchGoogleDatesResponse contains cheapest-date results from Google Flights.

dates
object[]
degraded
boolean
error
string