Search Room Endpoint

Fetches available rooms, rates, cancellation rules, amenities, and hotel images for a selected hotel.

• Endpoint: /api/v1/tourmind/hotels/{slug}/rooms
• Method: GET

Headers

Header	Value	Required	Description
Partner-Access-Token	Base64 String	Yes	Your encrypted AES-256 time-sensitive token.
X-Currency	Currency Code	Yes	Requested currency code, e.g. THB or MMK.
Accept	application/json	Yes

Path Parameters

Parameter	Type	Required	Description
slug	String	Yes	Hotel slug.

Query Parameters

Parameter	Type	Required	Description
check_in	String	Yes	Date format YYYY-MM-DD.
check_out	String	Yes	Date format YYYY-MM-DD.
rooms	Integer	Yes	Requested room quantity.
adults	Integer	Yes	Adult quantity.
children	Integer	Optional	Children quantity.
children_ages	Array	Optional	Child ages.

Example URL

/api/v1/tourmind/hotels/best-western-sukhumvit-20-757293/rooms?check_in=2026-06-27&check_out=2026-06-28&rooms=1&adults=2

Sample Response

{
  "result": 1,
  "message": "success",
  "data": {
    "hotel_code": 757293,
    "hotel_name": "Best Western Sukhumvit 20",
    "currency": "THB",
    "check_in": "2026-06-27",
    "check_out": "2026-06-28",
    "requested_adults": 2,
    "requested_rooms": 1,
    "rooms": [
      {
        "id": 478022,
        "room_type_code": "5328888",
        "room_type_name": "Superior Twin Room - Non-Smoking",
        "bed_type_desc": "",
        "images": [
          {
            "links": {
              "70px": {
                "href": "http://tm-lodging-content.tourmind.cn/lodging/img/757293/49d33c5f_t.jpg",
                "method": "GET"
              },
              "350px": {
                "href": "http://tm-lodging-content.tourmind.cn/lodging/img/757293/49d33c5f_b.jpg",
                "method": "GET"
              },
              "1000px": {
                "href": "http://tm-lodging-content.tourmind.cn/lodging/img/757293/49d33c5f_z.jpg",
                "method": "GET"
              }
            },
            "caption": "Room",
            "category": 21001,
            "hero_image": false
          }
        ],
        "room_options": [
          {
            "adults_covered": 2,
            "children_covered": 0,
            "requested_adults": 2,
            "requested_children": 0,
            "exceeded": {
              "is_exceeded": false,
              "adults_over_capacity": 0,
              "children_over_capacity": 0
            },
            "rates": [
              {
                "rate_code": "v2069812937153069057_68_2|TH",
                "rate_name": "Superior Twin Room - Non-Smoking",
                "bed_type_desc": "",
                "meal_type": null,
                "meal_count": 0,
                "is_refundable": true,
                "allotment": 2,
                "total_price": 1444.79,
                "tax_amount": 211.61,
                "total_with_tax": 1656.4,
                "price_per_night": 1444.79,
                "price_per_night_with_tax": 1656.4,
                "currency": "THB",
                "cancel_policies": [
                  {
                    "from": "2026-06-26 00:00:00",
                    "to": "2026-06-27 23:59:59",
                    "amount": 291.28,
                    "currency": "CNY",
                    "display_amount": 1656.4,
                    "display_currency": "THB",
                    "timezone_label": "Asia/Bangkok"
                  }
                ],
                "cancel_info": {
                  "type": "fee",
                  "amount": 1656.4,
                  "currency": "THB"
                },
                "daily_prices": [
                  {
                    "date": "2026-06-27",
                    "price": 1444.79,
                    "price_with_tax": 1656.4
                  }
                ]
              }
            ]
          }
        ]
      }
    ],
    "hotel_amenities": [
      {
        "name": "Internet access"
      }
    ],
    "room_amenities": [
      {
        "name": "Towels provided"
      }
    ],
    "hotel_images": [
      {
        "links": {
          "70px": {
            "href": "http://tm-lodging-content.tourmind.cn/lodging/img/757293/68faf48b_t.jpg",
            "method": "GET"
          },
          "350px": {
            "href": "http://tm-lodging-content.tourmind.cn/lodging/img/757293/68faf48b_b.jpg",
            "method": "GET"
          },
          "1000px": {
            "href": "http://tm-lodging-content.tourmind.cn/lodging/img/757293/68faf48b_z.jpg",
            "method": "GET"
          }
        },
        "caption": "Lobby",
        "category": 10001,
        "hero_image": false
      }
    ]
  }
}

Use the room option occupancy at checkout

The adults and children you send in the Checkout payload must match the adults_covered and children_covered of the room option you selected — not the guest counts you originally searched with.

A room option reports the occupancy it actually covers, which may differ from your request. For example, searching for 3 adults may return an option with adults_covered: 2; booking that option means sending "adults": 2. Sending the searched quantities instead will cause the rate to be rejected at checkout.

Check exceeded.is_exceeded to see whether a room option falls short of the requested occupancy, and book an additional room where it does.

Response Fields

Field	Type	Description
requested_adults	Integer	Requested adult quantity.
requested_rooms	Integer	Requested room quantity.
rooms	Array	Available room types.
rooms.images	Array	Room images.
rooms.room_options	Array	Room occupancy options for the requested guests.
rooms.room_options.adults_covered	Integer	Adults covered by this room option.
rooms.room_options.children_covered	Integer	Children covered by this room option.
rooms.room_options.exceeded	Object	Indicates whether requested occupancy exceeds the room option capacity.
rooms.room_options.rates	Array	Available rates for the room option.
rate_code	String	Rate code required for checkout.
total_price	Number	Total price without tax and fees.
total_with_tax	Number	Total price including tax and fees.
cancel_policies	Array	Cancellation policy records.
cancel_info	Object	Simplified cancellation summary.
daily_prices	Array	Daily price breakdown.