com.fostay/hotels

Verify a completed booking: confirmation status, hotel confirmation code, stay and price. Requires the Fostay booking id AND the guest email it was booked under (both are in the guest's confirmation). Use after the human pays via a prepare_booking link.

Fostay's editorial demand calendar (UAE only — Dubai and Abu Dhabi; Goa has no event calendar yet): the upcoming date windows where Dubai and Abu Dhabi hotels predictably spike or sell out (GITEX, F1, NYE, Eid, school breaks...), each with a suggested book-by deadline. Use it to warn users about expensive dates or find event stays.

Where to stay for a major UAE event, in one call: hotels grouped by distance to the venue (at the venue, nearby, rest of the city), each with live all-in prices for the event's own dates, whether rooms were found, refundability and a link that opens the hotel on those dates. Use it for questions like 'best hotels for the Abu Dhabi Grand Prix / F1', 'where to stay near Yas Marina Circuit' or 'is the F1 weekend sold out'. Currently supports: abu-dhabi-f1-2026, abu-dhabi-f1-2027 (the Abu Dhabi Grand Prix at Yas Marina Circuit: 3-7 December 2026 and 9-13 December 2027). Also returns Fostay's editorial advice for the event and when to book. To book a hotel, pass its hotel_id and an offer from get_live_rates to prepare_booking.

Live bookable room offers for one hotel and stay dates: total all-in price (in the hotel's home currency: INR for Goa, AED for Dubai and Abu Dhabi, AUD, NZD, SGD or EUR for the other cities, or the currency you pass), board (breakfast etc.), refundability and exact free-cancellation deadlines. For Goa, total_all_in counts GST, and any part the hotel collects at check-in is itemised separately (collected_by_hotel_at_checkin). The booking_url takes a human straight to this hotel on fostay.com to complete the booking.

Books everything except the payment: holds the chosen offer (real prebook — the price is locked while the hold lasts), registers the guest details, and returns a payment_url. The human opens that link, sees the exact stay summary, and pays in one step — the agent never handles card details. Confirm the guest's name and email with the user before calling. If the held price differs from what you quoted, this returns the final price and any change warnings — tell the user before sending them to pay.

Search hotels in Dubai, Abu Dhabi, Goa, Sydney, Melbourne, Auckland, Singapore, Madrid or Barcelona. For Sydney, Melbourne, Auckland, Singapore, Madrid and Barcelona, returns the city's best guest-rated 4–5★ hotels (any hotel when searched by name), with live all-in prices when checkin and checkout are given (in the city's own currency: AUD, NZD, SGD or EUR, or another Fostay can charge), a fostay_url that opens each hotel on those dates, the city's areas, and links to Fostay's pages for it (where to stay by area, hotels with harbour views or a pool, venues). For Dubai and Abu Dhabi, returns Fostay's hand-curated edit first (8 flagship stays with editorial verdicts), then catalog matches (~2,000 bookable hotels). For Goa, returns the best-reviewed hotels and resorts (hostels and homestays only when searched by name), optionally narrowed to one area. For Dubai and Abu Dhabi, pass checkin and checkout to get live all-in prices for the shortlist in the same call (from_total_all_in, from_per_night, refundable, rooms_available), a fostay_url that opens each hotel on those exact dates, and any major event (F1, GITEX, National Day, NYE...) those dates fall in. Without dates, use get_live_rates for prices. For the Abu Dhabi Grand Prix call event_stays instead: it ranks hotels by distance to the circuit. Results include a fostay_url where a human can view photos, live rates and book.

Prices upcoming weekends (Fri–Sun, 2 nights) to find the cheapest times to stay. Pass hotel_id for one hotel across ~8 weekends, or just a city to compare Fostay's curated stays (Dubai, Abu Dhabi) or top-rated Goa hotels across the next ~6 weekends. Cheapest options first.