Hotel Search Endpoint

Searches hotels by destination or hotel name. Use this after a user selects a suggestion.

• Endpoint: /api/v1/tourmind/hotels/search
• Method: POST

Headers

Header	Value	Required	Description
Partner-Access-Token	Base64 String	Yes	Your encrypted AES-256 time-sensitive token.
Content-Type	application/json	Yes
Accept	application/json	Yes

Payload 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, e.g. [3, 8].
country_code	String	Optional	ISO 3166-1 alpha-2 country code.
hotel_code	String	Optional	Provider hotel code when searching a specific hotel.
city	String	Optional	City name.
country	String	Optional	Country name.
name	String	Optional	Hotel name.
page	Integer	Optional	Page number.
per_page	Integer	Optional	Number of records per page.

Sample Payload

{
  "check_in": "2026-06-26",
  "check_out": "2026-06-27",
  "rooms": 1,
  "adults": 2,
  "children": 0,
  "country_code": "TH",
  "hotel_code": "",
  "city": "Bangkok",
  "country": "Thailand",
  "children_ages": [],
  "name": "",
  "page": 1,
  "per_page": 20
}

Sample Response

{
  "result": 1,
  "message": "success",
  "data": {
    "hotels": [
      {
        "id": 28082,
        "hotel_code": 749588,
        "hotel_name": "Hotel Muse Bangkok, Autograph Collection",
        "slug": "hotel-muse-bangkok-autograph-collection-749588",
        "city": "Bangkok",
        "country_code": "TH",
        "star_rating": 5,
        "address": "55/555 Langsuan Road, Pathumwan, 10330",
        "latitude": 13.74006,
        "longitude": 100.54328,
        "images": [],
        "amenities_hotel": [
          {
            "name": "Banquet hall"
          }
        ],
        "from_price": null,
        "from_price_with_tax": null,
        "currency": "USD",
        "meal_type": null,
        "refundable": null
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 20,
      "total": 894,
      "last_page": 45,
      "has_more": true
    },
    "filter_options": {
      "star_ratings": [5, 4, 3],
      "price_range": {
        "min": 0,
        "max": 0
      },
      "amenities": ["Banquet hall"],
      "cancellation_policies": {
        "refundable": false,
        "non_refundable": false
      },
      "breakfast_included": false
    },
    "effective_rooms": 1,
    "requested_rooms": 1,
    "rooms_adjusted": false
  }
}

Notes

Price fields in this response may be null. Use the Search Hotel Price endpoint to retrieve live prices.