Top Rate Tours Endpoint

Fetches the tours pinned as top rate for your partner account. Returns an empty array when nothing is pinned. At most 15 tours are returned, in random order.

• Endpoint: /api/v1/discover/tours/top-rate
• 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

This endpoint takes no parameters.

Sample Response

{
  "result": 1,
  "message": "success",
  "data": [
    {
      "id": 3,
      "name": "Chiang Mai Animals Planet Day Tour",
      "slug": "3-chiang-mai-animals-planet-day-tour",
      "code": "CMDT-70301",
      "days": 1,
      "nights": 0,
      "latitude": 18.8374886,
      "longitude": 98.8606363,
      "radius": 50,
      "is_meal": true,
      "meal_description": "<p><span style=\"font-size:12pt;line-height:107%;font-family:Aptos, sans-serif;\">Lunch at the elephant camp</span></p>",
      "is_accommodation": false,
      "accommodation_description": null,
      "description": "<p><span style=\"font-size:12pt;line-height:107%;font-family:Aptos, sans-serif;\">Explore Chiang Mai's ...",
      "highlight": "<ul>\n<li><span style=\"font-size:12pt;line-height:107%;font-family:Aptos, sans-serif;\"><strong>Elepha ...",
      "video_link": null,
      "included": "<ul>\n<li><span style=\"font-size:12pt;line-height:107%;font-family:Aptos, sans-serif;\">Round-trip tra ...",
      "excluded": "<ul>\n<li><span style=\"font-size:12pt;line-height:107%;font-family:Aptos, sans-serif;\">Items of a per ...",
      "meet_up": null,
      "type": "day_tour",
      "category": "private_tour",
      "type_label": "Day Tour",
      "category_label": "Private Tour",
      "featured_image": "https://onlynx-asset.s3.ap-southeast-1.amazonaws.com/tours/IqkOqhxBtvMPeOmEqsA9rdmpbQ4ZFjP5r5fcISHk.jpg",
      "galleries": [
        {
          "url": "https://onlynx-asset.s3.ap-southeast-1.amazonaws.com/UAT/tours/IZ074gkT16LcxmEGOp830M18SulxVyKDjK2I2lMV.jpg"
        },
        {
          "url": "https://onlynx-asset.s3.ap-southeast-1.amazonaws.com/UAT/tours/N9XyX7KwOkqxyINIKtFHINRw8HxOOeYfSFVjlc4a.jpg"
        }
      ],
      "travel_styles": [
        {
          "id": 1,
          "name": "Family"
        },
        {
          "id": 2,
          "name": "Adventure"
        },
        {
          "id": 21,
          "name": "Nature"
        }
      ],
      "country": {
        "id": 219,
        "name": "Thailand",
        "code": "TH",
        "iso3": "THA"
      },
      "cities": {
        "id": 112122,
        "name": "Chiang Mai"
      },
      "currency": "THB",
      "price": 2530,
      "sale_price": 2700
    }
  ]
}

price is the lowest package price including your margin, and sale_price the matching discounted price. Both are converted to the requested currency.