POSTHotel

Get Geo

/hotel/geo/list

Find a geographic region identifier from a country and location keyword before hotel discovery.

Source: API Documentation.pdf, pages 2-3

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

Source ambiguityThe source parameter table labels `lat` with the longitude example and `lan` with the latitude example, while the response uses `lon` and `lat`. Both source forms are preserved for review.

Parameters

Name	Type	Example	Description
`countryCode`Required	String	`ID`	ISO country code used to filter the search region. Example: ID for Indonesia.
`offset`Required	Integer	`0`	Starting index of the result list (used for pagination).
`limit`Required	Integer	`15`	Maximum number of records to return per request.
`key`Required	String	`Denpasar`	Keyword used to search for a geographic location (e.g., city name, area name).
`geoId`	String	`102747`	Unique identifier of the geographic region. Used for hotel search and discovery APIs.
`parentId`	String	`102746`	Parent geographic region ID (e.g., province or higher-level region).
`type`	String	`CITY`	Type of geographic region (e.g., CITY, AREA, REGION).
`name`	String	`Denpasar`	Official name of the region.
`localeName`	String	`Denpasar`	Localized name of the region (based on locale setting).
`centroid`	Object	`-`	Geographic coordinate information of the region.
`lat`	String (Decimal)	`115.2219942212104 8`	Longitude coordinate of the region.
`lan`	String (Decimal)	`-8.67189642353182 7`	Latitude coordinate of the region.
`valid`	Boolean	`True`	Indicates whether the coordinate data is valid.