search_trips
Search Daytrip transfers
Search Daytrip private door-to-door car transfers between two places (city to city, airport to city, …) and get bookable prices for every vehicle class.
Returns one of:
- status "ok": options[] (one per vehicle class) with price, capacity, duration and expiresAt, plus the resolved origin/destination and departureAt (local time). Present the options that fit the party (fitsPassengers) to the customer; when they choose, call get_quote with the option's offerId and vehicle.type (then book_trip with the quote), or get_booking_link with the same arguments for the traveler to finish on daytrip.com. availableStops[] lists sightseeing stops on the way with their extra cost per vehicle class (priceByVehicle, keyed by vehicle.type) and default time at the stop; offer them and pass the chosen ones to get_quote or get_booking_link. Only options with stopsAllowed can take stops (Lite classes are direct rides).
- status "ambiguous_location" (code AMBIGUOUS_LOCATION): field says whether origin or destination was unclear, candidates[] lists the places it could mean. Ask the customer, then call search_trips again passing the chosen candidate's label verbatim in that field.
- status "location_not_found" (LOCATION_NOT_FOUND): ask for a city, airport or IATA code.
- status "invalid_departure" (INVALID_DEPARTURE): fix the date/time and retry.
- status "route_not_available" (ROUTE_NOT_AVAILABLE): Daytrip does not serve that trip; suggest a nearby city/airport or another date.
- status "price_unavailable" (PRICE_UNAVAILABLE): nothing could be priced for that date; suggest another date.
When talking to the customer, describe options by vehicle name and price and never mention ids, tool names or internal steps. Prices are per vehicle (not per person), all-inclusive and valid until expiresAt. price is in the trip's pricing currency; when a currency was requested and priceInRequestedCurrency is present, that is the amount the checkout charges, so quote that one to the customer. Only one-way
输入参数adults必填localeorigin必填childrencurrencydepartureAt必填destination必填additionalLuggage
get_quote
Quote a Daytrip transfer
Price one search_trips option exactly as it will be booked: the chosen vehicle, the party and any stops. Returns everything the traveler must see before committing (seller, total price and currency, what is included, when they are charged, cancellation policy and free-cancellation deadline) and a single-use quoteId for book_trip.
Returns one of:
- status "quoted": present price, cancellationTerms and paymentTiming to the traveler; if previousPrice is set, the price differs from the search option and must be confirmed again. The quote can be booked until expiresAt; afterwards call get_quote again.
- status "offer_expired" (OFFER_EXPIRED): the search option is gone; call search_trips again.
- status "route_not_available" (ROUTE_NOT_AVAILABLE): the trip can no longer be priced; call search_trips again or suggest alternatives.
- status "invalid_input" (INVALID_INPUT): the vehicleType or a stop does not belong to that offer, or a customStops place could not be resolved; the message says what to fix.
Nothing is reserved and no personal data is needed. Each call prices the trip afresh.
输入参数stopsadults必填localeofferId必填childrencurrencycustomStopsvehicleType必填additionalLuggage
get_booking_link
Prepare a Daytrip booking on daytrip.com (handover link)
Prepare a search_trips option on daytrip.com and return a link where the traveler finishes the booking themselves. Nothing is charged and no personal data is needed: on the link the traveler enters their name, email and phone, optional pickup address and flight number, and pays.
Use this when the traveler prefers to finish on the website, or when book_trip is not available to you. It does not create a booking.
Returns one of:
- status "handover": give handoverUrl to the traveler and tell them to open it, complete their details and pay. summary describes the trip; the quoted price is held until expiresAt (the link keeps working afterwards, but the price may be re-quoted).
- status "price_changed" (PRICE_CHANGED): the price moved since the search. Tell the traveler the new price; if they accept, call get_booking_link again with the returned offerId.
- status "offer_expired" (OFFER_EXPIRED): call search_trips again and offer the fresh options.
- status "route_not_available" (ROUTE_NOT_AVAILABLE): the trip can no longer be booked; call search_trips again or suggest alternatives.
- status "invalid_input" (INVALID_INPUT): the vehicleType or a stop does not belong to that offer, or a customStops place could not be resolved; the message says what to fix.
Stops: pass availableStops entries as stops (price is known from the search) or other places as customStops (re-priced). The returned price is the total including stops.
Nothing is reserved or charged by this tool: the booking exists only once the traveler pays on the website. Never mention ids, tool names or internal steps to the traveler. Each call creates a new booking draft; call it once per confirmed choice.
输入参数stopsadults必填localeofferId必填childrencurrencycustomStopsvehicleType必填additionalLuggage