POSTHotel

Get Rates

/hotel/rate

Retrieve property-level availability, pricing, cancellation, and nightly rate breakdowns.

Source: API Documentation.pdf, pages 16-22

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)	`2026-02-22`	Check-in date.
`checkOutDate`Required	Date (YYYY-MM-DD)	`2026-02-23`	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	`1`	Number of adult guests.
`displayCurrency`	String	`IDR`	Currency for displayed pricing.
`isExtended`	Boolean	`true`	Indicates whether extended rate details are requested.
`propertyIds`	Array (String)	`["9685533"]`	List of property IDs to retrieve rates.
`success`	Boolean	`true`	Indicates request status.
`data`	Array (Object)	`-`	List of rate results per property/room.
`propertyId`	String	`9685533`	Property identifier.
`rateStatus`	String	`AVAILABLE`	Availability status of the rate.
`roomId`	String	`11525132##217857 233`	Unique room rate identifier.
`roomName`	String	`Deluxe Room`	Room display name.
`roomType`	String	`Deluxe Room`	Room category/type.
`numRooms(response)`	Integer	`1`	Number of rooms in rate result.
`numAdults(response)`	Integer	`1`	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., BF = Breakfast).
`bedArrangement`	Array (Object)	`-`	Bed configuration information.
`totalRates`	Object	`-`	Total pricing information for stay.
`nightlyRates`	Object	`-`	Nightly rate breakdown.
`charges`	Array (Object)	`-`	Additional charges (e.g., tax, service fee).
`rateKey`	String	`-`	Unique rate identifier for validation/booking.
`cancellationPolicy`	Object	`-`	Cancellation policy information.
`checkInPolicy`	Object	`-`	Check-in policy details.
`lastUpdatedTime`	Long / Null	`null`	Timestamp of last rate update.
`occupancyPricing`	Object	`-`	Detailed pricing breakdown per occupancy.
`cancelPenalties`	Array (Object)	`-`	Cancellation penalty details.
`bedGroups`	Array (Object)	`-`	Bed group configuration.
`facilityData`	Array (Object)	`-`	Included facilities for the rate.
`distribution`	Boolean	`false`	Indicates distribution channel flag.
`refundable`	Boolean	`true`	Indicates if the rate is refundable.
`smokingAllowed`	Boolean	`false`	Indicates if smoking is allowed.
`isRefundable`	Boolean	`true`	Refundable flag (system-level).
`isSmokingAllowed`	Boolean	`false`	Smoking allowed flag (system-level).

Headers

{
"Authorization": "<access token>",
"Content-Type": "application/json"
}

Request body

{
"checkInDate": "2026-02-22",
"checkOutDate": "2026-02-23",
"language": "en",
"userNationality": "ID",
"numRooms": 1,
"numAdults": 1,
"displayCurrency": "IDR",
"isExtended": true,
"propertyIds": [
"9685533"
]
}

Response body

{
"success": true,
"data": [
{
"propertyId": "9685533",
"rateStatus": "AVAILABLE",
"roomId": "11525132##217857233",
"roomName": "Deluxe Room",
"roomType": "Deluxe Room",
"numRooms": 1,
"numAdults": 1,
"numChildren": 0,
"maxOccupancy": 2,
"checkInDate": "2026-02-22",
"checkOutDate": "2026-02-23",
"mealType": "BF",
"bedArrangement": [
{
"bedroomLayouts": [
{
"arrangements": [
{
"bedType": "FullBed",
"total": 1
}
],
"arrangementType": "1 Double Bed",
"id": "37316"
}
]
}
],
"totalRates": {
"displayCurrency": "IDR",
"displaySellAmount": 1050001,
"displayNettAmount": 1050001,
"partnerCurrency": "IDR",
"partnerSellAmount": 1050001,
"partnerNettAmount": 1050001
},
"nightlyRates": {
"displayCurrency": "IDR",
"displaySellAmount": 1050001,
"displayNettAmount": 1050001,
"partnerCurrency": "IDR",
"partnerSellAmount": 1050001,
"partnerNettAmount": 1050001
},
"charges": [
{
"type": "TAX",
"displayCurrency": "IDR",
"displayAmount": 182232,
"included": false
}
],
"rateKey": "<rate-key>",
"cancellationPolicy": {
"text": "<text>",
"displayText": "<text>",
"propertyTimezone": null,
"policies": null
},
"checkInPolicy": {
"checkInDate": "2026-02-22",
"checkOutDate": "2026-02-23"
},
"lastUpdatedTime": null,
"occupancyPricing": {
"nightly": [
[
{
"type": "tax_and_service_fee",
"value": "182232",
"currency": "IDR"
},
{
"type": "base_rate",
"value": "867769",
"currency": "IDR"
}
]
],
"stay": [],
"fees": null,
"totals": {
"inclusive_strikethrough": {
"billable_currency": {
"type": "",
"value": "1400001",
"currency": "IDR"
},
"request_currency": {
"type": "",
"value": "1400001",
"currency": "IDR"
}
},
"property_inclusive": {
"billable_currency": {
"type": "",
"value": "1050001",
"currency": "IDR"
},
"request_currency": {
"type": "",
"value": "1050001",
"currency": "IDR"
}
},
"exclusive": {
"billable_currency": {
"type": "",
"value": "867769",
"currency": "IDR"
},
"request_currency": {
"type": "",
"value": "867769",
"currency": "IDR"
}
},
"strikethrough": {
"billable_currency": {
"type": "",
"value": "1157025",
"currency": "IDR"
},
"request_currency": {
"type": "",
"value": "1157025",
"currency": "IDR"
}
},
"property_inclusive_strikethrough": {
"billable_currency": {
"type": "",
"value": "1400001",
"currency": "IDR"
},
"request_currency": {
"type": "",
"value": "1400001",
"currency": "IDR"
}
},
"inclusive": {
"billable_currency": {
"type": "",
"value": "1050001",
"currency": "IDR"
},
"request_currency": {
"type": "",
"value": "1050001",
"currency": "IDR"
}
},
"property_fees": null
}
},
"cancelPenalties": [
{
"start": 1771149600000,
"end": 1771754400000,
"amount": null,
"currency": "IDR",
"percent": "100%"
}
],
"bedGroups": [
{
"id": "37316",
"description": "1 Double Bed",
"links": {
"price_check": {
"method": "GET",
"href": "<href>"
}
},
"configuration": [
{
"type": "FullBed",
"size": "Full",
"quantity": 1
}
]
}
],
"facilityData": [
{
"id": "1073742786",
"name": "Free breakfast"
}],
"distribution": false,
"refundable": true,
"smokingAllowed": false,
"isRefundable": true,
"isSmokingAllowed": false
}
]
}