cancel_booking
ChatGPTCancel a booking by booking ref and guest email. First call preview_cancel and show the guest its fee and refund; cancel only after they agree, with its preview_token. Refused if the terms or amounts changed since the preview (call preview_cancel again). Not blocked when the hotel pauses AI assistants — cancelling stays the guest's right. Returns refund details per the hotel's cancellation policy.
check_availability
ChatGPTCheck room availability and prices for a hotel slug on date range. Each room's stay_total is the all-in price of the whole stay (taxes and charges included, in the hotel's currency) for guests guests per room — quote that, not price_per_night, as the total; pass guests so per-person taxes are counted right. Each room's rate_plans lists the plans it is sold on (rate_plan_id, name, refundable, inclusions, and the plan's own stay_total) — pass a rate_plan_id in a rooms[] entry of preview_booking / create_booking to book that plan. Accepts show_cards: false to suppress widget cards for background checks, or selected_room_ids to filter specific rooms.
create_booking
ChatGPTBook rooms at a hotel on Stayantra. The reservation is placed with the hotel and the hotel is notified. First call preview_booking and show the user its cancellation terms, payment and total with the Terms of Service and cancellation links; book only after the user agrees, with accepted_terms: true. Online payment is currently unavailable: payment_method must be 'pay_at_hotel', the booking is confirmed at once (status confirmed), the guest pays the hotel during the stay, and no paymentUrl is returned. A non-refundable rate must be paid in full online, which is currently unavailable, so it cannot be booked here (NON_REFUNDABLE_REQUIRES_PREPAYMENT): offer the guest a refundable rate. For several rooms on the same dates, send rooms (one entry per room, each with room_type_id and guest_count) instead of room_type_id and guest_count — ONE call books them as one reservation. One reservation holds at most the hotel's reservation_caps from check_availability (max_rooms rooms and max_guests guests in total) — each hotel sets its own; beyond that, or for weddings, tours and conferences, use request_group_booking. A guest holding a group code from the hotel passes it as group_code (the group's rate applies and that limit does not). When you are signed in with a Stayantra account, the booking is always created in that account's own name and email — guest_name and guest_email are ignored.
file_complaint
ChatGPTFile a complaint on a guest's own booking. Category options: housekeeping, maintenance, service, food, billing, staff, other. Identify the booking with booking_ref and guest_email (or send a valid X-Booking-Proof header). The complaint is automatically queued for triage.
get_booking
ChatGPTRetrieve booking details by booking ref and guest email.
get_event_halls
ChatGPTOne hotel's event halls: layouts and capacities, amenities, and the slots free on a date (every slot when no date is given). Pass guests to keep only halls that seat that many. Nothing is reserved by asking: request_event_quote sends the hotel a quote request, and only when the guest accepts the hotel's quote (on Stayantra) is the hall held, temporarily, until the deposit.
get_guest_stay_context
ChatGPTReturns a guest's stay details and folio summary. Identify the stay with booking_ref and guest_email (or send a valid X-Booking-Proof header).
get_hotel
ChatGPTRetrieve the canonical knowledge node for a hotel by its slug. Accepts show_cards: false for silent retrieval.
get_my_event_requests
ChatGPTThe signed-in Stayantra guest's own event hall quote requests, newest first, with the hotel's quote once it has priced one. canAccept is true when a quote can be accepted; accepting happens on Stayantra (My event requests). Requires a Stayantra sign-in; API keys and booking proofs are refused.
get_neighborhood
ChatGPTNearby places (dining, shopping, attractions, services, transit) within 1.5 km of the hotel, from Google Maps, looked up live. When you show them, credit "Google Maps" exactly as written and link each place's google_maps_uri. Do not plot them on any map other than a Google map.
modify_booking
ChatGPTModify a booking's dates and/or room type by booking ref and guest email. First call preview_modify with the same change and show the guest its new total and difference; change the booking only after they agree, sending the same new dates / room type with its preview_token. Refused if the price or the booking changed since the preview (call preview_modify again), and while the hotel has paused changes made through AI assistants. Returns the new booking ref and any price delta settled at check-in.
preview_booking
ChatGPTCall before create_booking. Returns what the user must see and agree to before booking: the hotel's cancellation terms in plain words, how payment works, the total, and links to Stayantra's Terms of Service and the cancellation terms. Show the user summary_for_guest (with both links) and ask whether they agree. Nothing is reserved by previewing. A non-refundable rate must be paid in full online, which is currently unavailable, so it cannot be booked here (NON_REFUNDABLE_REQUIRES_PREPAYMENT): offer the guest a refundable rate.
preview_cancel
ChatGPTCall before cancel_booking. Returns exactly what cancelling this booking now does to the guest's money under the hotel's terms: the cancellation fee, the refund and its currency, and the window it falls in (free cancellation or the late-cancellation fee). Show the guest summary_for_guest and ask whether to cancel; nothing is cancelled by previewing. Returns the preview_token cancel_booking requires.
preview_modify
ChatGPTCall before modify_booking. For new dates and/or a new room type (at least one of new_check_in_date, new_check_out_date, new_room_type_id), returns the new total, the difference from the current total, the fee (none), what is refunded or left to pay, and whether a room is free — nothing is changed by previewing. Show the guest summary_for_guest and ask whether to make the change. Returns the preview_token modify_booking requires for exactly this change. Refused while the hotel has paused changes made through AI assistants.
request_event_quote
ChatGPTSend a hotel a quote request for one of its event halls, in the signed-in Stayantra guest's own account. Nothing is reserved: the hotel replies with a quote (see get_my_event_requests), and only when the guest accepts it on Stayantra is the hall held temporarily, until the deposit. Before calling, confirm with the user the hall (hall_id from get_event_halls or search_event_halls — its maxCapacity must seat the guests), the date, the slot key from its freeSlots, and the guest count. Requires a Stayantra sign-in; API keys and booking proofs are refused.
request_group_booking
ChatGPTSend a hotel a group request — for a party that needs more rooms or guests than one reservation may hold (the hotel's reservation_caps from check_availability), or for a wedding, tour or conference. Nothing is reserved: the hotel reviews the request and replies to the contact by email, with a group code to book the rooms with (create_booking's group_code) if it accepts. Confirm the dates, rooms and headcount with the user first. When you are signed in with a Stayantra account, the request is sent under that account's own email — contact_email is ignored.
request_service
ChatGPTRaise a housekeeping, maintenance, amenity, or other service request on a guest's own booking, or book a wake-up call (serviceType other, dueTime HH:MM on the hotel clock). Identify the booking with booking_ref and guest_email (or send a valid X-Booking-Proof header).
search_event_halls
ChatGPTSearch event halls (weddings, receptions, conferences, parties) at publicly listed hotels that seat the guest count, optionally in a city and with a free slot on a date. Only halls whose largest layout seats the guests are returned, grouped by hotel. Nothing is reserved by asking: request_event_quote sends the hotel a quote request, and only when the guest accepts the hotel's quote (on Stayantra) is the hall held, temporarily, until the deposit.
search_hotels
ChatGPTSearch for publicly listed active hotels in a city, or near a point (lat/lng/radius_km). Accepts show_cards: false to suppress widget cards for background queries, or selected_hotel_ids to filter cards.