Turkish Airlines

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

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_feedback_status

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 office in Istanbul') — leave it out for a general contact request. Does NOT handle bookings, baggage cases, or feedback.

get_contact_info

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.

manage_booking_link

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.

pnr_finder

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

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 questions; do not invent details beyond them. This returns reference text (no card). Does NOT check a specific booking, baggage case, or feedback status.

search_thy_faq

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.

search_hotel_packages