SlickTrip

The 38 tools it listed

"Read only" and "Changes data" are the server's own marks. Underlined parameters are required.

1. add_flight_bucket_list

   Add a flight bucket list

   Call this tool when the traveler wants to be alerted about a route over flexible dates, for example "tell me when New York to Tokyo drops under $700 this winter". SlickTrip keeps searching the months or dates the traveler chose and alerts them when a fare is under their price limit. It returns a bucket_id. When the traveler asks to be alerted, call it now: that is their go-ahead. Otherwise offer it first. Use the months, the number of nights and the price limit the traveler gave you, and the defaults for anything they did not say (every month on sale, 3 to 10 nights, 1 traveler); then tell them what you assumed. They can change any of it with update_bucket_list. Do not use this tool for fixed dates. Search those dates with search_flights, then use track_flight to watch the flight the traveler picks.

   origin destination months start_date end_date trip_type min_nights max_nights max_stops max_price_usd price_is_total cabin travelers airlines depart_days return_days name exclude_airlines depart_after depart_before arrive_after arrive_before max_duration_hours connecting_airports exclude_connecting_airports min_layover_hours max_layover_hours lower_emissions carry_on_bags checked_bags user_request

2. add_hotel_bucket_list

   Add a hotel bucket list

   Use for flexible-date hotel watches on a place or one named hotel: SlickTrip keeps searching stays of the given length across the chosen months or date window and alerts when a stay clears the per-night bar. Returns a bucket_id. When the traveler asks to be alerted, call it now; otherwise offer it first. Not for fixed dates (search_hotels, then track_hotel).

   location nights months start_date end_date adults max_price_per_night min_stars check_in_days hotel_name user_request

3. booking_optionsRead only

   Sellers for an itinerary

   Use when the traveler wants to book flights they have chosen: the sellers offering that exact itinerary (airline direct and agencies), each with its price and a link that opens its checkout on the seller's site. Takes a complete itinerary_id: one-way from search_flights, round trip from search_return_flights. Not for an outbound alone (choose a return first) and not a price watch (track_flight).

   itinerary_id

4. check_my_watchesRead only

   Check every watch

   Use for a routine check of everything the traveler watches (for example a daily scheduled check, or "anything new on my watches?"): what dropped, what rose, new lows and the alerts SlickTrip sent in the last since_hours, with whether each moved price is lower than usual. One call covers every flight, bucket list, hotel and seat watch, from SlickTrip's records; it never runs a new search. For one watch in full, use watch_details.

   since_hours

5. explore_destinationsRead only

   Cheapest places to go

   Use when the traveler wants the cheapest place to fly from somewhere, or ideas for where to go, instead of a destination they already chose: "the cheapest flight from Warsaw, anywhere", "where can I go cheaply", "the cheapest city in Brazil". Returns destinations cheapest first with the airline, stops and a search_url: priced on the traveler's dates when you give depart_date (and return_date for a round trip), else each on its own cheapest dates in the coming months.

   origin country_or_region max_price_usd trip_type travelers cabin nonstop max_results depart_date return_date abroad user_request

6. find_placesRead only

   Find airport and city codes

   Use when unsure of an airport or city code before searching. Matches a place name or code and returns the code to pass as origin or destination, whether it is one airport or all airports in a city, and the airports a city code covers. Not needed for well-known codes like JFK or LHR.

   query limit

7. flight_lookupRead only

   Flights on a route that day

   Call this tool when the traveler wants to know which flights operate on a route on a given date, or when you need a flight number for seat_availability or track_seats. It returns the departure and arrival times, the airline, the aircraft and the stops. It does not return prices. To find prices, use search_flights.

   origin destination depart_date flight_number display user_request

8. get_accountRead only

   The SlickTrip account

   Use before offering text alerts, or when the traveler asks about their account: name, member since, which alert channels work (text needs a phone verified on the site), the plan and its free limit, and how many fares, stays, seats and bucket lists are watched.

9. handoff_linkRead only

   Link into SlickTrip

   Use when the traveler wants to continue on slicktrip.com, wants to send a flights or hotels search to someone (a bucket_list link saves the list for whoever opens it, so never send one), or the account is not connected: builds a link that lands them fully configured without running a search (a flights search with a track_url that starts tracking on arrival, a bucket list that saves on arrival, a hotel search, or the seat tracker).

   kind origin destination depart_date return_date cabin travelers flight_numbers legs months start_date end_date min_nights max_nights max_stops airlines max_price_usd location check_in check_out adults children_ages max_price_per_night min_stars hotel_id flight_number

10. hotel_booking_optionsRead only

    Sellers for a hotel

    Use when the traveler wants to book a hotel from search_hotels: every seller quoting it for those dates (the hotel itself and booking sites), each with the stay total and a link that opens its checkout on the seller's site. Takes the search_key and hotel_id from search_hotels. Not a price watch (track_hotel).

    search_key hotel_id

11. hotel_detailsRead only

    Hotel details

    Use when the traveler asks for the details, more information, photos, rooms or description of one hotel from search_hotels: description, photos, guest rating, amenities, the sellers' stay totals, the rooms, check-in and check-out times. Takes the search_key and hotel_id from search_hotels. Not for prices across dates (hotel_price_calendar). Booking links are hotel_booking_options; call that only when they say book.

    search_key hotel_id

12. hotel_price_calendarRead only

    Hotel price calendar

    Use for 'when is this hotel cheapest' (signed-in account): one hotel's nightly price by check-in date across a span of months. Needs a hotel_id from search_hotels. Then search_hotels with the chosen dates to track it.

    hotel_id start_month end_month hotel_name

13. list_bucket_listsRead only

    List bucket lists

    Use to see the flight and hotel bucket lists on the signed-in account, each with its settings, the best deals found so far, and the bucket_id that update_bucket_list, remove_bucket_list and share_link take.

    limit name

14. list_tracked_flightsRead only

    List tracked flights

    Use to see the flight price alerts on the signed-in account: route, dates, cabin, alert settings, each itinerary's current price against the price when tracking began, and the search_key and fid that stop_tracking_flight and update_flight_tracking take.

    limit

15. list_tracked_hotelsRead only

    List tracked hotels

    Use to see the hotel price alerts on the signed-in account: stay dates, guests, each hotel's current price against the price when tracking began, and the tracking_id and hotel_id the update and stop tools take.

    limit

16. list_tracked_seatsRead only

    List tracked seats

    Use to see the seat alerts on the signed-in account: flight, departure, cabin, the seats watched and which are open now, and the tracking_key the update and stop tools take.

    limit

17. price_calendarRead only

    Price calendar

    Use price_calendar only for a traveler who is flexible within a period they named (for example "sometime in March", "any weekend in December", "this winter"), has told you how many nights they want to stay, and wants to know which days are cheapest. It shows the cheapest fare for each departure day, across about two months starting with the month you give. With max_stops=0 it also shows which days have a nonstop flight, for a traveler who is flexible within a period they named and wants a nonstop. Every price in the calendar is for one exact trip: a set number of nights away, one cabin, one number of travelers, and one set of stops, airlines and times. If any of these is guessed, every price in the calendar is for a trip the traveler will not take. Before you call it, you need from the traveler: the month or period, and for a round trip the number of nights they want to stay. Also pass any preferences the traveler gave you: nonstop or not, airlines, times of day, cabin, and number o

    origin destination month trip_type trip_length_days cabin travelers lap_infants max_stops airlines exclude_airlines depart_after depart_before arrive_after arrive_before max_duration_hours connecting_airports exclude_connecting_airports min_layover_hours max_layover_hours lower_emissions carry_on_bags checked_bags depart_from depart_to user_request

18. recent_dealsRead only

    Recent deals

    Use for 'any deals right now?': the freshest price-drop alerts SlickTrip actually sent, by category (flights, hotels, seats, flexible routes). Not a search; no account needed.

19. remove_bucket_listChanges data

    Remove a bucket list

    Use to stop a bucket list (bucket_id from list_bucket_lists). Cannot be undone; confirm first.

    bucket_id

20. route_airlinesRead only

    Airlines on a route

    Use when the traveler asks who flies a route, or before filtering by airline: the carriers on the route, nonstop ones first, with the codes the airlines filters take. Not a fare search.

    origin destination

21. search_flightsRead only

    Search flights

    Call this tool to find flights once the traveler has told you their dates. It handles one-way trips, round trips, two possible dates each way, and up to three airports on each side at once. Before you call it, you need four things from the traveler: where they are flying from, where they are flying to, the date they want to leave, and, for a round trip, the date they want to come back. If the traveler has not told you any of these, ask them for everything that is missing in one question. Do not pick dates for the traveler. Do not guess whether the trip is one way or a round trip. A question like "what is the cheapest flight from Newark to Los Angeles" still needs dates. Ask the traveler when they want to go and whether it is one way or a round trip, then call this tool. If the traveler does not have dates yet, offer to set up a bucket list alert with add_flight_bucket_list, which watches the route for them and alerts them when a good fare appears. Search as soon as you have those fo

    origin destination depart_date return_date cabin travelers lap_infants max_results query max_stops airlines exclude_airlines connecting_airports exclude_connecting_airports min_layover_hours max_layover_hours no_overnight_layovers lower_emissions carry_on_bags checked_bags max_price_usd max_duration_hours depart_after depart_before arrive_after arrive_before sort legs display user_request

22. search_hotelsRead only

    Search hotels

    Use when the traveler wants a place to stay for known dates. Returns hotels cheapest first with star class, guest rating, per-night and whole-stay price, hotel_ids and a search_key for track_hotel and hotel_price_calendar, and a search_url. Filters match the site: price, stars, guest rating, property kinds, amenities, free cancellation, hotels or vacation rentals, bedrooms (rentals), sort. Not for flexible months (add_hotel_bucket_list).

    location check_in check_out adults children_ages max_results max_price_per_night min_price_per_night min_stars min_guest_rating property_type property_kinds amenities free_cancellation min_bedrooms sort brand user_request

23. search_return_flightsRead only

    Search return flights

    Use after search_flights when the traveler wants a specific return, or the next leg of a multi-city trip (once per remaining leg). Takes an outbound itinerary_id; returns complete itineraries with the trip total, needs_leg false once the trip is whole. Filters apply to the leg being chosen. Not needed for an outbound watch.

    itinerary_id max_results max_stops airlines exclude_airlines connecting_airports exclude_connecting_airports min_layover_hours max_layover_hours no_overnight_layovers lower_emissions carry_on_bags checked_bags max_price_usd max_duration_hours depart_after depart_before arrive_after arrive_before sort display

24. seat_availabilityRead only

    Seat availability

    Use to see which seats are open right now on one flight (needs a signed-in SlickTrip account; nothing is charged or changed): open seat numbers by row, counts of window, aisle, middle and exit-row seats, and rows with two seats together. Needs the flight number, route and date. Then track_seats to be told when a seat opens. Not for prices.

    flight_number origin destination depart_date cabin user_request

25. share_link

    Share a trip

    Use when the traveler wants to share a tracked route or a flight bucket list: a public slicktrip.com link, the same one the site's Share button makes, showing the itinerary and its price and nothing about the account. Made once and reused. To share a flights or hotels search that is not watched (a guest, or before a watch is set), use handoff_link with kind flights or hotels instead: it needs no watch and no sign-in. Never a bucket_list handoff link: it saves the list for whoever opens it.

    search_key bucket_id

26. shared_tripRead only

    Open a shared trip

    Use when the traveler pastes a slicktrip.com/share link: the shared itinerary or bucket list and its current price, so they can start their own watch on it. Takes the link or its code. Not for making a link (share_link).

    share_url

27. stop_tracking_flightChanges data

    Stop tracking a flight

    Use to stop price alerts for a tracked route (search_key from list_tracked_flights), or one itinerary in it (fid). Cannot be undone; confirm first.

    search_key fid

28. stop_tracking_hotelChanges data

    Stop tracking a hotel

    Use to stop price alerts for a tracked stay (tracking_id from list_tracked_hotels), or one hotel in it (hotel_id). Cannot be undone; confirm first.

    tracking_id hotel_id

29. stop_tracking_seatsChanges data

    Stop tracking seats

    Use to stop the seat alert on one flight (tracking_key from list_tracked_seats). Cannot be undone; confirm first.

    tracking_key

30. track_flight

    Track a flight's price

    Use to start price alerts on an itinerary from a search, after the traveler confirms (asking for alerts is confirming). One way: any itinerary_id from search_flights. Round trip: an outbound itinerary_id from search_flights watches that outbound with its cheapest return; a complete itinerary_id from search_return_flights tracks that exact pairing. Multi-city: a complete itinerary_id. Alerts go to the account's channels on a new low; alert_rule any hears every move; target_price_usd sets a bar.

    itinerary_id alert_rule target_price_usd email text

31. track_hotel

    Track a hotel's price

    Use to start price alerts on one hotel from search_hotels for those dates, after the traveler confirms. Alerts go to the account's channels when the price drops.

    search_key hotel_id search_url alert_rule target_price_usd email text

32. track_seats

    Track seats on a flight

    Use to start seat alerts on one flight, after the traveler confirms: named seats, or every seat of a kind (window, aisle, middle, any), optionally only when N seats open together in a row. Alerts go to the account's channels when a watched seat opens.

    flight_number origin destination depart_date seats seat_type seats_together cabin email text

33. update_account

    Update the account

    Use to change the display name, or the default alert channels (email, text) for new alerts, optionally applied to everything already watched. Phones are verified on the site, not here. Only the fields given change. Confirm first.

    name email text apply_to_all

34. update_bucket_listChanges data

    Update a bucket list

    Use to edit a bucket list: the price bar, months or date window, nights, stops, airlines, preferred weekdays, name, guests, stars, or channels, and a flight list's filters (airlines left out, connecting airports, times, duration, layovers, emissions, bags). Only the fields given change; a filter given replaces the stored one, and clear_filters names the ones to remove. A changed search resets the deals found so far. Confirm first.

    bucket_id max_price_usd price_is_total months start_date end_date clear_window min_nights max_nights max_stops airlines depart_days return_days name adults min_stars check_in_days email text exclude_airlines connecting_airports exclude_connecting_airports depart_after depart_before arrive_after arrive_before max_duration_hours min_layover_hours max_layover_hours lower_emissions carry_on_bags checked_bags clear_filters

35. update_flight_tracking

    Update flight alert settings

    Use to change how a tracked route alerts: the alert rule, a target price, or the email and text channels. Only the fields given change. Confirm first.

    search_key alert_rule target_price_usd email text

36. update_hotel_tracking

    Update hotel alert settings

    Use to change how a tracked stay alerts: the alert rule, a target price, the email and text channels, or its name. Only the fields given change. Confirm first.

    tracking_id alert_rule target_price_usd email text name

37. update_seat_tracking

    Update seat alert settings

    Use to pause or resume a seat alert, or change its seats-together rule or channels. To watch different seats call track_seats again (it adds to the alert). Only the fields given change. Confirm first.

    tracking_key alerts_on seats_together email text

38. watch_detailsRead only

    One watch in detail

    Use when the traveler asks about ONE of their watches (a tracked flight, a bucket list, a hotel stay or a seat watch): how it is doing, its price history, when it went up or down, the alerts sent. Returns its settings, the price now against the first price seen, the lowest and highest with dates, every recorded price move with its time (oldest first), each day's low and high and the alerts sent (flights), the best dates found (bucket lists), and when the last alert went out. Not for listing every watch (use the list_ tools).

    watch