get_itinerary_details
Get detailed information about a specific flight itinerary. Returns comprehensive details including:
- Complete flight segments with airline, flight number, times, and aircraft type
- Departure and arrival terminals (if available)
- Baggage allowance (checked bags, carry-on, personal item limits)
- Layover information (duration, airport, overnight status)
- Fare rules (refundability, change policy, fees)
- Price breakdown (base fare, taxes, fees)
- Booking URL for purchase
Use this when user asks for:
- 'Tell me more about this flight'
- 'What are the baggage allowances?'
- 'Is this flight refundable?'
- 'Show me the layover details'
- 'What terminals will I use?'
WIDGET NOTE: If this tool's results are displayed in a visual widget alongside your response, do NOT repeat the itinerary details in text format. Instead, briefly confirm the details are shown. Do NOT prompt users with instructions like 'say show details for RefNo X' — the widget already displays the details interactively. Only use the formatting instructions below when NO visual widget is rendering the results.
PRESENTATION FORMATTING (MANDATORY):
- Present detailed information in well-formatted sections. Group by flight leg, segment, and then rules/baggage.
- CRITICAL: ALWAYS display full names with codes for better readability:
* Airports: Use format 'City Name (CODE)' - Example: 'Colombo (CMB)', 'London Heathrow (LHR)', 'Dubai (DXB)'
* Airlines: Use format 'Airline Name (CODE)' - Example: 'Emirates (EK)', 'British Airways (BA)', 'Flydubai (FZ)'
* NEVER display codes alone (CMB, DXB, EK, etc.) - users don't recognize them
* ALWAYS include both the full name and code in parentheses
search_flights
Search for flights between cities. Returns categorized JSON results:
1. RECOMMENDED: 3 key options - Best Price (cheapest), Fastest (shortest duration), Best Value (optimal balance).
2. BY AIRLINE: Cheapest option per airline with total available count. Users can filter for specific airlines to see all options.
3. ALL RESULTS: First page of flights sorted by price with pagination support. Page size varies by configuration.
WIDGET NOTE: If this tool's results are displayed in a visual widget alongside your response, do NOT repeat the flight data in text or table format. Instead, briefly acknowledge the results (e.g., number of flights found, price range). Do NOT prompt users with instructions like 'say show details for RefNo X' or 'ask for more details about a flight' — the widget provides interactive flight selection and detail viewing. Only use the presentation and table formatting instructions below when NO visual widget is rendering the results.
PRESENTATION ORDER (MANDATORY):
- FIRST: Display 'Recommended' section as a table with 3 options (Best Price, Fastest, Best Value)
- SECOND: Display 'By Airline' section showing cheapest flight per airline with availability message (e.g., 'Flydubai (FZ): £220.10 - 5 total options available. Ask to filter by FZ to see all.')
- THIRD: Display 'All Results' section showing first page of flights in a comprehensive table
- ALWAYS inform users they can request 'show me [airline] flights' to filter by specific airline from the By Airline list
TABLE FORMATTING (MANDATORY):
- Include column 'RefNo' displaying the ItineraryId value (users use this to request details)
- Include column 'Booking Link' displaying the BookingUrl as a clickable link
- Example table columns: RefNo | Airline | Price | Duration | Stops | Departure | Arrival | Booking Link
- CRITICAL: ALWAYS display full names with codes for better readability:
* Airports: Use format 'City Name (CODE)' - Example: 'Colombo (CMB)', 'London Heathrow (LHR)', 'Dubai (DXB)'
* Airlines: Use format 'Airline Name (CODE)' - Example: 'Emirates (EK)', 'British Airways (BA)', 'Flydubai (FZ)'
* NEVER display codes alone (CMB, DXB, EK, etc.) - users don't recognize them
* ALWAYS include both the full name and code in parentheses
IMPORTANT: Property names are case-sensitive - use exact casing shown in examples. Each flight offer includes a BookingUrl field for immediate booking.
get_more_results
Get additional pages of flight search results from cache. Use this when the user asks for 'more results', 'next page', 'show me more flights', or wants to see flights beyond the initial results. Optionally apply filters to cached results (airline, max stops, max price) without making a new API call. Retrieves results instantly from cache. Requires the searchId from a previous search response.
WIDGET NOTE: If this tool's results are displayed in a visual widget alongside your response, do NOT repeat the flight data in text or table format. Instead, briefly summarize the page results. Do NOT prompt users with instructions like 'say show details for RefNo X' — the widget provides interactive flight selection and detail viewing. Only use the table formatting instructions below when NO visual widget is rendering the results.
TABLE FORMATTING (MANDATORY):
- ALWAYS format results as a comparison table
- Include column 'RefNo' displaying the ItineraryId value (users use this to request details)
- Include column 'Booking Link' displaying the BookingUrl as a clickable link
- Example table columns: RefNo | Airline | Price | Duration | Stops | Departure | Arrival | Booking Link
- Include pagination info and offer details below table
- CRITICAL: ALWAYS display full names with codes for better readability:
* Airports: Use format 'City Name (CODE)' - Example: 'Colombo (CMB)', 'London Heathrow (LHR)', 'Dubai (DXB)'
* Airlines: Use format 'Airline Name (CODE)' - Example: 'Emirates (EK)', 'British Airways (BA)', 'Flydubai (FZ)'
* NEVER display codes alone (CMB, DXB, EK, etc.) - users don't recognize them
* ALWAYS include both the full name and code in parentheses
Each flight offer includes a BookingUrl field for immediate booking.