POSTHotel

Discovery

/hotel/v1/list

Discover available properties for a geo ID, stay dates, occupancy, and currency.

Source: API Documentation.pdf, pages 13-16

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
`geoId`Required	String	`102813`	Geographic ID used to search properties.
`checkInDate`Required	Date (YYYY-MM-DD)	`2026-01-22`	Check-in date.
`checkOutDate`Required	Date (YYYY-MM-DD)	`2026-01-23`	Check-out date.
`numRooms`Required	Integer	`1`	Number of rooms requested.
`displayCurrency`	String	`IDR`	Currency used to display pricing.
`sortBy`	String	`HIGHEST_PRICE`	Sorting option for results.
`filters`	Object	`-`	Filter criteria such as star rating and price range.
`cursor`	String	`-`	Cursor value for pagination.
`page`	Integer	`1`	Page number for pagination.
`limit`	Integer	`10`	Maximum number of records per page.
`totalProperties`	String	`1038`	Total number of properties found.
`maximalOffset`	String	`1038`	Maximum offset value available.
`properties`	Array (Object)	`-`	List of available properties based on search criteria.
`nextCursor`	String / Null	`null`	Cursor value for next page retrieval.
`totalPages`	String	`1038`	Total number of pages available.
`propertyId`	String	`9695753`	Unique property identifier.
`propertySummary`	Object	`-`	Summary information of the property.
`propertyImages`	Array (Object)	`-`	Property image information.
`cheapestRoomName`	String	`Superior Room, 1 King Bed`	Name of the cheapest available room.
`cheapestRoom`	Object	`-`	Cheapest available room information.
`rateKey`	String	`<rate_key>`	Unique rate identifier used for rate validation and booking.

Headers

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

Request body

{
"geoId": "102813",
"checkInDate": "2026-01-22",
"checkOutDate": "2026-01-23",
"numRooms": 1,
"displayCurrency": "IDR",
"sortBy": "HIGHEST_PRICE",
"filters": {
"starRating": [
false,
false,
true,
true,
true
],
"priceRange": {
"min": 0,
"max": 3200000
}
},
"cursor": "",
"page": 1,
"limit": 10
}

Response body

{
"totalProperties": "1038",
"maximalOffset": "1038",
"properties": [
{
"propertyId": "9695753",
"propertySummary": {
"name": "Mercure Convention Center
Ancol",
"formerName": "Mercure Convention Center
Ancol",
"address": {
"lines": [
"Jl. Pantai Indah - Ancol
Jakarta"
],
"city": "Jakarta",
"province": "",
"postalCode": "14430",
"country": "ID"
},
"phoneNumber": "",
"localAddress": {
"lines": [
"Jl. Pantai Indah - Ancol
Jakarta"
],
"city": "Jakarta",
"province": "",
"postalCode": "14430",
"country": "ID"
},
"starRating": "4",
"reviewScore": null,
"accommodationType": "HOTEL",
"geoLocation": {
"lat": "-6.122477",
"lon": "106.83627"
},
"countryISO": "",
"geoId": ""
},
"propertyImages": [
{
"entries": [
{
"imageType": "SMALL",
"url": "<url>"
}],
"main": true,
"isMain": true
}],
"cheapestRoomName": "Superior Room, 1 King
Bed, Park View",
"cheapestRoom": {
"chargeableRate": {
"currencyCode": "IDR",
"averageBaseRate": "1050001",
"averageRate": "1050001",
"nightlyRateTotal": "1050001",
"surchargeTotal": "182232",
"total": "1050001",
"surcharges": [
{
"type": "TAX",
"displayCurrency": "IDR",
"displayAmount": 182232,
"included": false
}
],
"nightlyRates": [
{
"date": "2026-01-22",
"baseRate": "1050001",
"promo": false,
"nightRate": "1050001"
}
],
"recommendedSellingPrice": null,
"serviceFeeCharges": "0",
"serviceFeeTotal": "0",
"chargeableRateInfo": ""
},
"convertedChargeableRate": null,
"numOfRooms": "1",
"roomId": "<room-id>"
},
"rateKey": "<rate_key>"
}
],
"nextCursor": null,
"totalPages": "1038"
}