Plan multi-city trips
plan_tripsRead-only
Generate cheap round trips through several cities, from cached flights. Accepts one departure city (from) or up to 5 (from_cities); with several, a trip can return to a different one of them. Returns trips sorted by total price. To share or book a trip, pass its flight_ids to save_trip.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Departure city name, exactly as returned by search_cities. Give from or from_cities. | |
| legs | Yes | Number of outbound flights before the flight home (1-7). The round trip adds one flight home, so the trip has legs+1 flights total. | |
| limit | No | Maximum number of trips to return, default 5, max 10. | |
| date_to | Yes | Latest return date, YYYY-MM-DD. | |
| date_from | Yes | Earliest departure date, YYYY-MM-DD. | |
| max_nights | No | Maximum nights in each city, default 3. | |
| min_nights | No | Minimum nights in each city, default 2. | |
| from_cities | No | Several departure cities (up to 5), exactly as returned by search_cities. A trip leaves from one of them and may return to any of them. | |
| exclude_cities | No | Never visit these cities. | |
| include_cities | No | Only visit these cities. | |
| exclude_countries | No | Never visit cities in these ISO country codes. | |
| include_countries | No | Only visit cities in these ISO country codes. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | Yes | ||
| trips | Yes |