Top Attraction Destinations Endpoint

Fetches the top attraction destinations for search entry points and discovery sections. Each destination carries its gallery images and the category groups you can pass on to an attraction search.

• Endpoint: /api/v1/discover/attractions/top-destinations
• 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	Number of destinations, between 1 and 50. Defaults to 6.

Sample Response

{
  "result": 1,
  "message": "success",
  "data": [
    {
      "city_name": "Tokyo",
      "city_code": "D-JP-3261",
      "slug": "japan-tokyo",
      "galleries": [
        {
          "url": "https://onlynx-asset.s3.ap-southeast-1.amazonaws.com/UAT/kkday_city_gallery/L1BGe5QBh5q5xT65sOJa98nhflH55yaLnKQLyl6J.jpg"
        }
      ],
      "categories": [
        {
          "label": "Transport & Essentials",
          "value": "CATEGORY_055,CATEGORY_066,CATEGORY_056,CATEGORY_059,CATEGORY_063,CATEGORY_067,CATEGORY_068,CATEGORY_072,CATEGORY_073,CATEGORY_095"
        },
        {
          "label": "Attractions & Tickets",
          "value": "CATEGORY_001,CATEGORY_002,CATEGORY_003,CATEGORY_004,CATEGORY_005,CATEGORY_006,CATEGORY_007,CATEGORY_008,CATEGORY_009,CATEGORY_010,CATEGORY_011,CATEGORY_012"
        }
      ]
    }
  ]
}