Marketing Hotel Collections Endpoint

Fetches curated hotel collections for marketing and discovery sections. Without a collection filter the response is grouped by collection, and empty collections are omitted.

• Endpoint: /api/v1/discover/hotels/collections
• Method: GET or POST

Headers

Header	Value	Required	Description
Partner-Access-Token	Base64 String	Yes	Your encrypted AES-256 time-sensitive token.
X-Currency	Currency Code	Optional	Requested currency code, e.g. THB or MMK. Defaults to your partner currency.
Accept-Language	Language Code	Optional	One of en, th, zh-cn, zh-tw, zh-hk, ja, vi, ko, mm. Defaults to en.
Accept	application/json	Yes

Query Parameters

Parameter	Type	Required	Description
limit	Integer	Optional	Maximum hotels per collection. Defaults to 10.
collection	String	Optional	Return one collection as a flat hotel list instead of the grouped response.

Collection Names

Value
Top Luxury 5-star Hotels
Budget-friendly Properties Worldwide
Top Rating Hotels

Sample Response

{
  "result": 1,
  "message": "success",
  "data": [
    {
      "collection": "Top Luxury 5-star Hotels",
      "hotels": [
        {
          "hotel_code": 763255,
          "hotel_name": "Bangkok City Inn",
          "slug": "bangkok-city-inn-763255",
          "collection": "Top Luxury 5-star Hotels",
          "country_code": "TH",
          "country_name": "Thailand",
          "city": "Bangkok (and vicinity)",
          "star_rating": 2,
          "address": "RAJDAMRI ROAD PATHUMWAN 43/5",
          "latitude": 13.748909,
          "longitude": 100.541644,
          "main_image": null,
          "background_image": null,
          "price": 2500,
          "currency": "THB",
          "original_price": 2500,
          "original_currency": "THB"
        }
      ]
    },
    {
      "collection": "Budget-friendly Properties Worldwide",
      "hotels": [
        {
          "hotel_code": 763489,
          "hotel_name": "Baiyoke Sky Hotel Bangkok",
          "slug": "baiyoke-sky-hotel-bangkok-763489",
          "collection": "Budget-friendly Properties Worldwide",
          "country_code": "TH",
          "country_name": "Thailand",
          "city": "Bangkok (and vicinity)",
          "star_rating": 4,
          "address": "222 Soi Ratchaprarop 3 Rathaprarop RoadRatchathewi, 10400",
          "latitude": 13.75408,
          "longitude": 100.54022,
          "main_image": null,
          "background_image": null,
          "price": 200,
          "currency": "THB",
          "original_price": 200,
          "original_currency": "THB"
        }
      ]
    }
  ]
}

When collection is sent, data is a flat array of the hotel objects shown above rather than an array of groups.