Turkish Airlines

CHECK EXISTING FLIGHT STATUS: Use this tool ONLY when the user wants to check the real-time status of a specific existing flight (e.g., 'check status of TK289', 'is flight TK001 on time?', 'what's the gate for TK815?'). This tool requires a specific flight number. DO NOT use this for searching/bookable flights - use 'search_flights' instead. This tool fetches real-time flight status information including departure/arrival times, gate, terminal, and current flight status (on time, delayed, landed, etc.).

flight-status

CHECK FLIGHT STATUS BY ROUTE: Use this tool ONLY when the user wants to check the real-time status of flights on a specific route for a specific date (e.g., 'what flights are flying from IST to SFO today?', 'check flights from Istanbul to San Francisco tomorrow'). This tool shows the status of flights that are already scheduled/flying on that route. DO NOT use this for searching/bookable flights or finding available flights to book - use 'search_flights' instead. This tool fetches real-time flight status information for flights on a given route and date.

flight-status-by-route

Fetch airline promotions. Inputs: country, airports. Use this when the user asks about promotions, special offers, or discounted flights.

get_airline_promotions

Fetch detailed booking baggage information. Tip: Call get_booking_details tool to retrieve the ticket number if not provided. Use this when the user asks about baggage allowance, baggage limits, or extra baggage for their booking.

get_booking_baggage_allowance

Retrieve detailed information about a flight booking using PNR or E-ticket number. Returns passenger details, flight segments, and status. Use this when the user wants to check their reservation, find their ticket number, or see flight details for a specific booking.

get_booking_details

Get a travel guide for a destination city, including what to see, where to go, transportation information, weather, and more. Use this when the user asks about a destination city, wants travel tips, or needs information about a place they're visiting.

get_city_guide

SEARCH FOR BOOKABLE FLIGHTS: Searches Turkish Airlines flights and returns available options with prices. Provide from, to, departureDate, passengers, and tripType. For round trips, also provide returnDate. For multi-city, use originDestinations array instead of from/to/departureDate. IMPORTANT — next step depends on trip type: (1) INTERNATIONAL round trip: returns outbound only — after user selects, call 'search_inbound_flights' for return flights. (2) DOMESTIC round trip: returns both outbound and inbound — do NOT call 'search_inbound_flights'. (3) One-way: returns all needed information. DO NOT use this for checking flight status — use flight-status tools instead.

search_flights

SEARCH FOR RETURN FLIGHTS (international round trips only): Call after the user picks an outbound option from search_flights. You only need to pass { searchId, optionId, recommendationId, returnDate } — searchId is returned by the preceding search_flights call and MUST be passed back verbatim; optionId and recommendationId come straight from the search_flights results; returnDate is YYYY-MM-DD. The session, outbound segments, taxes, and passengers are restored from the searchId. Do NOT fabricate or copy jSessionId, segments, or duTaxBean. Returns inbound flight options with combined round-trip pricing.

search_inbound_flights