check_availability
ChatGPTCheck live start times and remaining seats for a TripWays tour on one date or a range of up to 31 days. Pass party_size (seats needed) or a travelers object; slots that cannot fit the group are left out, and party_size wins if both are given. The status field is ok, no_schedule, no_fit, or calendar_gone. Use get_price_quote with the same date, start time, and travelers for the total.
compare_tours
ChatGPTCompare 2 to 4 TripWays tours side by side by bokun_id: from-price, duration, rating, cancellation type, hotel pickup, languages, inclusions, and exclusions. The result also names the tour with the lowest from-price, the shortest duration, the best rating (10+ reviews), and which have free cancellation. Ids that are not bookable tours come back in not_found. For group totals on a date, use check_availability and get_price_quote.
find_alternatives
ChatGPTFind tours similar to one TripWays tour that have open start times on a date, or a date range of up to 31 days, for a group. Pass the tour the traveler wanted (bokun_id), the date, and party_size or travelers. Returns up to limit similar tours (1 to 5, default 3), each with its card and up to three open start times with seats left, plus the original tour's own status for those dates. It reads several live calendars, so it can take a few seconds.
get_booking_link
ChatGPTGet the TripWays checkout link for a tour, optionally preset to a date, start time, rate, and traveler mix. The traveler pays on tripways.com; this tool does not hold seats or take payment. bookable_natively and reason say whether the link opens TripWays checkout or the operator's calendar, and whether a hotel pickup must be chosen at checkout.
get_cancellation_policy
ChatGPTGet the cancellation terms stored for one TripWays tour by bokun_id: the type (free, flexible, partial, or non_refundable), the refund percent and cutoff when the tour has them, and the operator's policy text. These are the tour's terms, not a quote for a specific booking.
get_destination_info
ChatGPTResolve a place name (a city, region, country, or well-known area such as Khao Sok) to a TripWays destination with bookable tours. Useful before search_tours when a name could mean more than one place. An ambiguous name returns destination_ambiguous with a did_you_mean list; pass country_code (ISO 3166-1 alpha-2, e.g. FR) to choose one. Area names resolve to their parent destination and include resolved_via=area_alias.
get_itinerary_ideas
ChatGPTSuggest a day-by-day plan of bookable TripWays tours for a destination. Pass destination, days (1 to 7, default 3), and optional interests such as food, history, or boat trips. Each day holds one full-day tour or a morning and afternoon pair, with from-prices and links; multi-day tours are listed apart. These are suggestions only: dates, seats, and group totals are not checked.
get_meeting_point
ChatGPTGet where one TripWays tour starts, by bokun_id: the operator's meeting point text, whether hotel pickup is available, and the operator's know-before-you-go notes and what to bring. Fields the operator has not filled in are left out, with a note when nothing is stored.
get_price_quote
ChatGPTGet the live total for a TripWays tour on one date and start time for a traveler mix, priced from the operator's booking calendar. A quote does not hold seats or charge anything. Optional extras and promo codes are not included. When the tour's rates cannot price that mix, the result is unpriced.
get_tour_details
ChatGPTGet the full details of one TripWays tour by bokun_id (the number in tripways.com/t/{id}): summary, itinerary stops, inclusions and exclusions, languages, cancellation policy, meeting point or pickup, from-price, rating, hero_image, url, and checkout_url. Live dates and group totals come from check_availability and get_price_quote.
get_tour_reviews
ChatGPTGet the rating summary and written reviews for one TripWays tour by bokun_id. Written reviews come from travelers who booked on TripWays and carry first name, country, date, star rating, and text; the overall rating can also include ratings from other platforms. limit sets how many written reviews to return (1 to 10, default 5, newest first).
search_tours
ChatGPTSearch the TripWays catalog of bookable tours, day trips, and activities worldwide. Pass a natural-language query plus any filters you already know: destination, price range in USD, duration in hours, activity, theme, or cancellation policy. Returns ranked tours with bokun_id, title, from-price, duration, destinations, rating, cancellation policy, hero_image, the TripWays page (url), and checkout_url. For live dates, remaining seats, or a group total, use check_availability and get_price_quote.
