POSTHotel

Get Room Rates

/hotel/room-rate

Retrieve detailed room-level pricing and inclusions before selecting a rate.

Source: API Documentation.pdf, pages 22-27

Authorization required

Call the authentication endpoint first, then include the returned access token in the Authorization header together with Content-Type: application/json.

Parameters

Name	Type	Example	Description
`checkInDate`Required	Date (YYYY-MM-DD)	`2025-06-07`	Check-in date.
`checkOutDate`Required	Date (YYYY-MM-DD)	`2025-06-08`	Check-out date.
`language`	String	`en`	Language preference for response.
`userNationality`	String	`ID`	Guest nationality (ISO country code).
`numRooms`Required	Integer	`1`	Number of rooms requested.
`numAdults`Required	Integer	`2`	Number of adult guests.
`displayCurrency`	String	`IDR`	Currency for displayed pricing.
`isExtended`	Boolean	`true`	Indicates whether extended rate details are requested.
`propertyId`	String	`9685533`	Property identifier to retrieve room rates.
`success`	Boolean	`true`	Indicates request status.
`data`	Array (Object)	`-`	List of available room rate results.
`propertyId(response)`	String	`9685533`	Property identifier in response.
`rateStatus`	String	`AVAILABLE`	Availability status of the rate.
`roomId`	String	`<room-id>`	Unique room identifier.
`roomName`	String	`Suite, 2 Bedrooms, Kitchen`	Room display name.
`roomType`	String	`Suite, 2 Bedrooms, Kitchen`	Room category/type.
`numRooms(response)`	Integer	`1`	Number of rooms in rate result.
`numAdults(response)`	Integer	`2`	Number of adults in rate result.
`numChildren`	Integer	`0`	Number of children.
`maxOccupancy`	Integer	`2`	Maximum occupancy allowed.
`mealType`	String	`BF`	Meal inclusion type (e.g., Breakfast).
`bedArrangement`	Array (Object)	`-`	Bed configuration details.
`totalRates`	Object	`-`	Total pricing information for the stay.
`nightlyRates`	Object	`-`	Nightly rate breakdown.
`charges`	Array (Object)	`-`	Additional charges (tax/service fee).
`rateKey`	String	`<rate-key>`	Unique rate identifier for validation/booking.
`cancellationPolicy`	Object	`-`	Cancellation policy details.
`checkInPolicy`	Object	`-`	Check-in policy information.
`roomImages`	Array (Object)	`-`	Room image information.
`roomFacilities`	Array (Object)	`-`	Facilities available in the room.
`roomSize`	Object	`-`	Room size information.
`propertySummary`	Object	`-`	Summary information of the property.
`propertyImages`	Array (Object)	`-`	Property image information.
`propertyFacilities`	Array (Object)	`-`	Facilities available at the property.
`ratesPerDay`	Array (Object)	`-`	Daily rate breakdown.
`refundable`	Boolean	`true`	Indicates if the rate is refundable.
`wifiIncluded`	Boolean	`false`	Indicates if Wi-Fi is included.
`breakfastIncluded`	Boolean	`true`	Indicates if breakfast is included.
`smokingAllowed`	Boolean	`false`	Indicates if smoking is allowed.

{ "checkInDate": "2025-06-07", "checkOutDate": "2025-06-08", "language": "en", "userNationality": "ID", "numRooms": 1, "numAdults": 2, "displayCurrency": "IDR", "isExtended": true, "propertyId": "<property-id>" }

{ "success": true, "data": [ { "propertyId": "9685533", "rateStatus": "AVAILABLE", "roomId": "<room-id>", "roomName": "Suite, 2 Bedrooms, Kitchen", "roomType": "Suite, 2 Bedrooms, Kitchen", "numRooms": 1, "numAdults": 2, "numChildren": 0, "maxOccupancy": 2, "checkInDate": "2026-02-22", "checkOutDate": "2026-02-23", "mealType": "BF", "bedArrangement": [ { "bedroomLayouts": [ { "arrangements": [ { "bedType": "KINGBED", "total": 1 }, { "bedType": "QUEENBED", "total": 1 } ], "arrangementType": "DEFAULT", "id": "37533" } ] } ], "totalRates": { "displayCurrency": "IDR", "displaySellAmount": 1500001, "displayNettAmount": 1500001, "partnerCurrency": "IDR", "partnerSellAmount": 1500001, "partnerNettAmount": 1500001 }, "nightlyRates": { "displayCurrency": "IDR", "displaySellAmount": 1500001, "displayNettAmount": 1500001, "partnerCurrency": "IDR", "partnerSellAmount": 1500001, "partnerNettAmount": 1500001 }, "charges": [ { "type": "TAX", "displayCurrency": "IDR", "displayAmount": 260331, "included": false } ], "rateKey": "<rate-key>", "cancellationPolicy": { "text": "<text>", "displayText": "<text>", "propertyTimezone": null, "policies": null }, "checkInPolicy": { "checkInDate": "2026-02-22", "checkOutDate": "2026-02-23" }, "roomImages": [ { "entries": [ { "imageType": "SMALL", "url": "<url>" } ] } ], "roomFacilities": [ { "facilityId": "6176", "category": "", "name": "Non-Smoking" } ], "roomSize": { "size": "0", "unit": "SQUARE_METER" }, "propertySummary": { "name": "Umalas Suite", "formerName": "Umalas Suite", "address": { "lines": [ "Jl. Tegal Cupek Gg Wayang 11 No. 1" ], "city": "Kerobokan", "province": "Bali", "postalCode": "8036", "country": "ID" }, "phoneNumber": "", "localAddress": { "lines": [ "Jl. Tegal Cupek Gg Wayang 11 No. 1" ], "city": "Kerobokan", "province": "Bali", "postalCode": "8036", "country": "ID" }, "starRating": "3", "reviewScore": null, "accommodationType": "HOTEL", "geoLocation": { "lat": "-8.65137", "lon": "115.161" }, "countryISO": "", "geoId": "" }, "propertyImages": [ { "entries": [ { "imageType": "SMALL", "url": "<url>" } ], "main": true, "isMain": true } ], "propertyFacilities": [ { "id": null, "category": "", "name": "Airport transportation (surcharge)" } ], "ratesPerDay": [ { "date": "2026-02-22", "baseRate": "1500001", "promo": false, "nightRate": "1500001" } ], "refundable": true, "wifiIncluded": false, "breakfastIncluded": true, "smokingAllowed": false } ] }