---
title: "Retrieve minimum rate for hotels"
method: POST
path: "/hotels/min-rates"
tags: ["Hotel rates"]
---

# Retrieve minimum rate for hotels

`POST /hotels/min-rates`

## 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.

## Request body

- object
  - `hotelIds` string[], required — List of hotel IDs
  - `occupancies` object[], required
    - `adults` integer, required — Number of adults in each selected room
    - `children` integer[] — The ages of children of each selected room
  - `checkin` string, required — Check in date in YYYY-MM-DD (ISO 8601) format
  - `checkout` string, required — Check out date in YYYY-MM-DD (ISO 8601) format
  - `currency` string, required — Booking currency
  - `guestNationality` string, required — Guest nationality (ISO 2-code)
  - `timeout` number — Request timeout in seconds

## Response `200`

Successful response with hotel minimum rates

- object
  - `data` object[]
    - `hotelId` string, required
    - `price` number, required
    - `suggestedSellingPrice` integer
    - `offerId` string, required — The offer ID associated with the minimum rate, used for booking reference
  - `sandbox` boolean

## Other responses

- `401` — Bad Request

---

[API](https://skmtc.net/liteapi/apis/api-search.md) · [All operations](https://skmtc.net/liteapi/apis/api-search/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/liteapi/api-search/versions/315ba2a4dcf4/schema)