POSTHotel
Check Rates
/hotel/rate/check
Revalidate a selected rate key and return current availability and pricing before booking.
Source: API Documentation.pdf, pages 27-31Authorization 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 |
|---|---|---|---|
propertyIdRequired | String | 9685533 | Property identifier. |
roomIdRequired | String | <room-id> | Room identifier. |
checkInDateRequired | Date (YYYY-MM-DD) | 2026-06-07 | Check-in date. |
checkOutDateRequired | Date (YYYY-MM-DD) | 2026-06-08 | Check-out date. |
numRoomsRequired | Integer | 1 | Number of rooms to validate. |
numAdultsRequired | Integer | 1 | Number of adults. |
language | String | en | Language preference. |
displayCurrency | String | IDR | Currency for rate display. |
userNationality | String | ID | Guest nationality (ISO code). |
rateKey | String | <rate-key> | Unique rate key from previous rate search. |
success | Boolean | true | Indicates request status. |
data | Object | - | Validated rate details. |
rateStatus | String | AVAILABLE | Availability status of the selected rate. |
propertyId(response) | String | 9685533 | Property identifier. |
providerRoomId | String | <provider room id> | Room ID from provider system. |
roomId(response) | String | <room id> | 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 validated. |
numAdults(response) | Integer | 1 | Number of adults validated. |
numChildren | Integer | null | Number of children (if any). |
childrenAges | Array | null | Children ages (if applicable). |
bedArrangement | Object | null | Bed configuration details. |
mealType | String | null | Meal inclusion type. |
benefits | Object | null | Additional benefits included in rate. |
totalRates | Object | - | Total rate summary. |
nightlyRates | Object | - | Nightly pricing summary. |
charges | Array (Object) | - | Additional charges (tax/fees). |
rateKey(response) | String | <rate-key> | Final rate key for booking submission. |
cancellationPolicy | Object | null | Cancellation policy details. |
occupancyPricing | Object | - | Detailed pricing breakdown. |
refundable | Boolean | false | Indicates if rate is refundable. |
isRefundable | Boolean | false | Refundability flag. |