Search Flights
search_flightsFull Description
Use this to search flights between two cities and show them as a horizontal carousel widget.Call this tool at most once per user request.
Parameters (5 required, 2 optional)
countrystringISO 3166-1 alpha-2 country code used as booking market. IMPORTANT: Infer it from the trip ORIGIN (not destination). Examples: Amsterdam/AMS -> NL, Oslo/OSL -> NO. Always uppercase, 2 letters.
departureDatestringOutbound date in YYYY-MM-DD format. Validation: Date must be between [Today] and [Today + 1 Year]. On failure: Politely explain the limit and ask for a new date
destinationstringThe 3-letter IATA code for the destination city or airport. IMPORTANT: You MUST resolve user input (e.g., 'London') to its IATA code (e.g., 'LHR').If it is a city with multiple airports, return the city code (for example, London -> LON).
originstringThe 3-letter IATA code for the origin city or airport. IMPORTANT: You MUST resolve user input (e.g., 'Stockholm') to its IATA code (e.g., 'STO').If it is a city with multiple airports, return the city code (for example, London -> LON).
travellersstringNumber of adult travellers (e.g. '1' or '2'). If unspecified, default to 1
maxresultintegerMaximum number of flight options to return (1–5)
5returnDatestringOptional return date in YYYY-MM-DD format. Validation: Date must be between [Today] and [Today + 1 Year]. On failure: Politely explain the limit and ask for a new date