Turkish Airlines

Check Flight Status by Number

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

Check Flight Status by Route

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 flig

Search Flights

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 outbou

Search Inbound 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

Get City Guide

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 Airline Promotions

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

Get Booking Details

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 Baggage Allowance

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.

Manage Booking / Web Check-in Link

Validate a booking by PNR + surname and return the deeplink for the user to manage the reservation OR start online check-in on turkishairlines.com. Use this whenever the user wants to cancel, refund, rebook, change, upgrade, add services, add/remove passengers, OR check in online. Set linkType='manage' for booking changes; 'checkin' for online check-in. Do NOT preemptively send users to the website or call center before trying this tool.

Generate Baggage Issue Form Link

Generate a direct link to the official Turkish Airlines baggage issue tracing form, localized to the user's language. Use when the user reports a baggage problem (lost, damaged, delayed) and wants to file a formal claim. Does NOT handle existing baggage case status (use a future case-status tool) or baggage allowance (use get_booking_baggage_allowance).

Flight + Hotel Packages Link for a Route

Generate a Turkish Airlines Holidays link for Flight + Hotel packages on a specific round trip. The user clicks through to browse and book matching packages with their route, dates and travellers pre-filled. Use when the user's ORIGIN is known (stated, or from a prior flight search or booking) and they want holiday packages, campaigns or flight+hotel deals for a route — including as an upsell after a flight search. Prefer 3-letter IATA codes (originAirportCode/destinationAirportCode — the same c

Recover Lost PNR / Booking Reference

Securely recover a forgotten PNR by triggering Turkish Airlines to send it via SMS or email to the contact on file. Use when the user has lost their booking reference and remembers the flight + passenger details. For security, the PNR is NEVER displayed in chat — it is only sent to the registered phone/email. After this succeeds, ask the user to check their inbox/SMS, then use get_booking_details once they have it.

Find Cheapest Flight Dates

Find the cheapest fares around a target departure date for one travel leg. Ideal when the user is flexible with dates and wants to find the best price. For ROUND_TRIP, call once for the outbound (isReturnFlight=false). After the user picks an outbound date, call again with isReturnFlight=true and departureDate set to that chosen outbound date to get the return-date calendar. Use BEFORE search_flights when the user asks for 'cheapest', 'best price', or has flexible dates.

Search Turkish Airlines Holiday Packages

Browse Turkish Airlines Holiday packages (Flight + Hotel, Tours, Circuits) from the catalog. Use when the user asks about holiday packages, all-inclusive trips, flight+hotel deals, or wants recommendations with constraints (destination, budget, star rating, trip type). Specify the locale matching the user's market (e.g. en-US, de-DE, fr-FR). Country and resort filters MUST be in the locale's language. Returns a curated list with prices, hotel ratings, and direct booking links.

Get Baggage Case Status

Look up the status of an EXISTING baggage issue case using its case number and the email it was filed with. Use when the user asks to check on a previously reported lost/damaged/delayed baggage case. Does NOT file a new report (use generate_baggage_issue_link) or answer allowance questions (use get_booking_baggage_allowance). After showing the status, you may offer to add a message with add_message_to_baggage_case.

Add Message to Baggage Case

Add a new message to an EXISTING baggage issue case. This posts to the case on the customer's behalf, so only call it after the user has written the message they want to send. Requires the case number (look it up first with get_baggage_case_details if unsure) and the message text.

Get Feedback / Complaint Status

Check the status of a previously submitted feedback or complaint using its reference number (format: tk-12345678; the tk- prefix is optional). Use when the user asks about the status of their feedback, complaint, or application. Does NOT submit new feedback (direct them to feedback.turkishairlines.com) or check baggage cases (use get_baggage_case_details).

Get Turkish Airlines Contact Info

Get how to reach Turkish Airlines in a specific country: the call-center phone number by default, and — only when a city is given — the sales/ticket offices in that city (address and working hours). Use when the user asks for a Turkish Airlines phone number, call center, or office. Pass the country as a 2-letter ISO code (e.g. 'DE' for Germany); if omitted, the user's own location is used. Add the 'city' argument ONLY when the user asks about an office in a specific city (e.g. 'Turkish Airlines

Search Turkish Airlines FAQ

Look up Turkish Airlines' official FAQ answers for a topic. Use this when the user asks a general how-to or policy question about the airline that you should answer from official content rather than from memory — cabin/checked baggage rules, check-in, cancellations and changes, fare rules, pets, infants and children, visas and travel requirements, seats, lounges, and more. Choose the single closest 'topic' from the schema's fixed category list, then answer the user only from the returned questio

Check Stopover in Istanbul Eligibility

Check whether an EXISTING booking qualifies for Turkish Airlines' Stopover in Istanbul program (a free İstanbul hotel on a qualifying layover). Requires the booking reference (PNR or e-ticket) and passenger surname. For route-level questions without a booking, use check_stopover_routes instead.

Check Stopover in Istanbul Routes

Check whether one or more routes (origin → destination, transiting Istanbul) qualify for the Stopover in Istanbul accommodation program — without a specific booking. Use when the user asks whether stopovers are available on a given route or which destinations qualify. For a specific booking, use check_stopover_eligibility instead.

Business Upgrade Offers for a Booking

Check whether an existing booking can be upgraded to Business Class and return the current offers — per flight, per payment method (credit card or Miles&Smiles miles), with prices for all passengers on the booking. Use whenever the user asks to upgrade to Business, asks the price of an upgrade, or asks whether an upgrade is available for their PNR. Offers are session-bound and change over time: always call this first, then pass the chosen `optionId` + `paymentType` to create_business_upgrade_pay

Business Upgrade Payment Link

Final step of the Business upgrade flow: register the option the user picked with Turkish Airlines and return the link where they complete it — the card checkout page, or the Miles&Smiles offers page for miles upgrades. Call only after get_business_upgrade_offers, using an `optionId` and a `paymentType` taken verbatim from its result. The user pays on turkishairlines.com; this tool charges nothing and does not change the booking by itself.