Search Flights
search_flightsRead-onlyIdempotent
Search for flights between airports on a specific date, returning prices, durations, and leg details. Supports one-way and round-trip travel with filters for airlines, cabin class, stops, and more.
Instructions
Search for flights between two airports on a specific date.
Returns a list of available flights with prices, durations, and leg details. Supports one-way and round-trip searches with various filtering options.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| origin | Yes | Departure airport IATA code(s), comma-separated for multiple (e.g., 'JFK' or 'JFK,LGA') | |
| destination | Yes | Arrival airport IATA code(s), comma-separated for multiple (e.g., 'LHR' or 'LHR,CDG') | |
| departure_date | Yes | Travel date in YYYY-MM-DD format | |
| return_date | No | Return date in YYYY-MM-DD format (omit for one-way) | |
| departure_window | No | Departure time window in 'HH-HH' 24h format (e.g., '6-20') | |
| airlines | No | Filter by airline IATA codes (e.g., ['BA', 'AA']) | |
| cabin_class | No | Cabin class: ECONOMY, PREMIUM_ECONOMY, BUSINESS, FIRST | ECONOMY |
| max_stops | No | Maximum stops: ANY, NON_STOP, ONE_STOP, TWO_PLUS_STOPS | ANY |
| sort_by | No | Sort by: TOP_FLIGHTS, BEST, CHEAPEST, DEPARTURE_TIME, ARRIVAL_TIME, DURATION, EMISSIONS | CHEAPEST |
| passengers | No | Number of adult passengers | |
| exclude_basic_economy | No | Exclude basic economy fares from results | |
| emissions | No | Filter by emissions level: ALL or LESS | ALL |
| checked_bags | No | Number of checked bags to include in price (0, 1, or 2) | |
| carry_on | No | Include carry-on bag fee in displayed price | |
| show_all_results | No | Return all available results instead of curated ~30 |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||