POSTHotel

Get Hotel

/hotel

Retrieve hotel summaries for an area or keyword, including location, rating, images, and facilities.

Source: API Documentation.pdf, pages 4-7

Authorization required

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

Source notes

Display normalizationCurly quotation marks from the PDF were normalized to straight quotes for copyable code display; fields and values were otherwise retained.

Parameters

Name	Type	Example	Description
`area`Required	String	`Bali`	Area or region name to search hotels.
`count`Required	Integer	`1`	Number of results per request.
`key`Required	String	`Umalas`	Keyword to filter hotel name or location.
`page`Required	Integer	`0`	Page number for pagination.
`stars`Required	Boolean Array	`[true,true,true,true,tr ue]`	Filter by star rating (index 1-5 star).
`success`	Boolean	`true`	Indicates whether the request was successful.
`data`	Array (Object)	`-`	List of hotel properties matching the search criteria.
`totalData`	Integer	`57`	Total number of hotels found.
`totalPages`	Integer	`57`	Total number of pages available.
`id`	String	`9685533`	Unique property identifier.
`status`	String	`available`	Hotel availability status.
`name`	String	`Umalas Suite`	Hotel name.
`latitude`	Decimal	`-8.65137`	Hotel latitude coordinate.
`longitude`	Decimal	`115.161`	Hotel longitude coordinate.
`lineData`	Array	`-`	Address line information.
`city`	String	`Kerobokan`	City name.
`province`	String	`Bali`	Province name.
`postalCode`	String	`8036`	Postal code.
`country`	String	`ID`	Country code.
`star`	Integer	`3`	Star rating of the hotel.
`accommodationType`	String	`HOTEL`	Type of accommodation.
`propertyImageData`	Array	`-`	List of hotel images.
`facilityData`	Array	`-`	List of facilities available.
`rank`	Integer	`181621`	Internal ranking score.
`checkInInfo`	Object	`-`	Check-in information.
`checkOutInfo`	Object	`-`	Check-out information.
`feesInfo`	Object / Null	`null`	Additional fees information.
`policiesInfo`	Object	`-`	Hotel policy information.

{ "success": true, "data": [ { "id": "9685533", "status": "available", "name": "Umalas Suite", "latitude": -8.65137, "longitude": 115.161, "lineData": [ "Jl. Tegal Cupek Gg Wayang 11 No. 1" ], "city": "Kerobokan", "province": "Bali", "postalCode": "8036", "country": "ID", "star": 3, "accommodationType": "HOTEL", "propertyImageData": [ { "entries": [ { "imageType": "SMALL", "url": "<url>" }], "main": true, "isMain": true }], "facilityData": [ { "facilityId": "56", "category": "", "name": "Airport transportation (surcharge)" }], "rank": 181621, "checkInInfo": { "instructions": "<instructions>", "special_instructions": "<special_instructions>", "begin_time": "2:00 PM", "min_age": 15 }, "checkOutInfo": { "time": "12:00 PM" }, "feesInfo": null, "policiesInfo": { "instructions": null, "know_before_you_go": "know_before_you_go>" } } ], "totalData": 57, "totalPages": 57 }