v1

latestOpenAPI 3.0.02026-07-247251950.2 KB

Hotel rates

Retrieve minimum rate for hotels

Overview

Get the cheapest available rate for each hotel in your list. Perfect for displaying price comparisons without loading full rate details.

When to Use

Show price ranges on hotel listing pages
Quick price comparisons across multiple hotels
Optimize performance when you only need the lowest price, not all rate options
Build price filters or sorting by price

What You Get

Minimum rate per hotel - the cheapest available room option
Basic rate information - price, currency, and availability
Fast response - optimized for quick price lookups

Key Features

Lightweight - Returns only the minimum rate, not all options
Same parameters as the main rates endpoint for consistency
Perfect for listings - Ideal when displaying multiple hotels where users just need to see starting prices

Quick Start

Provide a list of hotel IDs, dates, and guest occupancy. The endpoint returns the cheapest rate available for each hotel.

post/hotels/min-rates

Request body

hotelIdsstring[] required

List of hotel IDs

checkinstring required

Check in date in YYYY-MM-DD (ISO 8601) format

checkoutstring required

Check out date in YYYY-MM-DD (ISO 8601) format

currencystring required

Booking currency

guestNationalitystring required

Guest nationality (ISO 2-code)

timeoutnumber

Request timeout in seconds

Example request

{
  "hotelIds": [
    "lp3803c",
    "lp1f982"
  ],
  "occupancies": [
    {
      "adults": 2,
      "children": [
        5,
        2
      ]
    }
  ],
  "checkin": "2027-02-15",
  "checkout": "2027-02-16",
  "currency": "USD",
  "guestNationality": "US",
  "timeout": 10
}

Response

Successful response with hotel minimum rates

sandboxboolean