/agoda/hotels/rooms

POST /api/agoda/hotels/rooms

Price: 20 credits

Get the live room rate grid for an Agoda hotel by property id (or hotel URL) for specific check-in / check-out dates and occupancy. Returns each available room type with its size, view and bed features, amenities, photos, guest review score and the list of bookable rate offers. Each offer carries the nightly price and currency, the rate plan, free-cancellation, breakfast, pay-later and pay-at-hotel flags, whether a credit card is required and how many rooms are left; the meal plan and cancellation policy where the rate has them, the price before discount and the discount on a discounted rate, the promotion name on a special offer, and on some offers the supplier id. Prices and availability depend on the requested dates and occupancy.

How to use it

Fetch the per-room rate grid for one Agoda hotel by numeric property id (or a hotel URL containing hotelId) for given check_in and check_out dates. Set adults, children_ages (one age per child) and rooms for the occupancy, and count for how many room types to return. Each room type lists its bookable rate offers; a sold-out room type has no offers and no min_price. amenities holds the room's top few amenities and amenity_groups the full list by category. original_price and discount_percentage are set on discounted rates only, promotion_name on special offers only. review_score is the room type's own guest score and is empty for room types without enough reviews. An empty result means the hotel has no rooms available for the selected dates.

Parameters

Request body

Response

Errors

Response headers