Skip to main content
POST
/
hotels
/
rates
Retrieve rates for hotels
curl --request POST \
  --url https://api.liteapi.travel/v3.0/hotels/rates \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "occupancies": [
    {
      "adults": 2,
      "children": [
        5,
        2
      ]
    }
  ],
  "currency": "USD",
  "guestNationality": "US",
  "checkin": "2026-07-01",
  "checkout": "2026-07-02",
  "hotelIds": [
    "lp1897"
  ],
  "timeout": 6,
  "maxRatesPerHotel": 1,
  "boardType": "RO",
  "refundableRatesOnly": true,
  "sort": [
    {
      "field": "top_picks",
      "direction": "ascending"
    }
  ],
  "roomMapping": true,
  "hotelName": "Hilton",
  "countryCode": "US",
  "cityName": "New York",
  "latitude": 34.052235,
  "longitude": -118.243683,
  "radius": 5000,
  "iataCode": "LAX",
  "limit": 10,
  "offset": 0,
  "aiSearch": "Romantic getaway with Italian vibes in London near the London Eye",
  "minReviewsCount": 100,
  "minRating": 4.5,
  "zip": "10012",
  "placeId": "ChIJYeZuBI9YwokRjMDs_IEyCwo",
  "starRating": [
    4,
    5
  ],
  "hotelTypeIds": [
    201,
    204,
    208
  ],
  "chainIds": [
    14675,
    14677
  ],
  "facilities": [
    1,
    2,
    3
  ],
  "strictFacilityFiltering": true,
  "stream": false,
  "advancedAccessibilityOnly": true,
  "feed": "custom_feed",
  "includeHotelData": true
}
'
{
  "data": [
    {
      "hotelId": "lp1897",
      "roomTypes": [
        {
          "roomTypeId": "GQ2TOLJWGI4TK7CSIZHHYMRQGI2TAMZTGAYDEMBQPQYXYURRGIYTO7BRGU3TGNY",
          "offerId": "GE5ESNBSIZKVMQ2QJJNEERSPKIZEMR2OIRKVOVCTKNFVMRCWKNLUWVKKGVDVMRKWGJEEWRSOIVEVCS2PJNJEEVKPK5FFKS2SI5LFKU2TLBETIMSGKVJEGQSKLJHEMR2SGIZEWUSDIUZFOU2TJM2UOVSFJZJUKSKOIVLFKVJSJBEUMTSFJFJTETSJJJFVKT2RJNNEYQSNKUZFKU2SJE2UKVCFKZBUESS2IJDEGURSJNDVURCVK5GTEVCHGVDFMTKTKNMUYRSMIVLVMQ2RJNFEMVSNKIZFGSKRGJCU6U2TIJFVEQKWINGVUVKJGVCVMVKSINJEUVK2KREVGMSWJRFEIRJSKYZEKS2OJFDEGV2LKVFDKSCFIVKUWSCHKFNEMSKTGJHUWSSNKVHVCSSUJFJEEVJUKEZEUSSSIJDE6U2DJZFEMTSGJ5JDESSHKJFUKV2TJMZEWVSEKZFU2MSUI5FEQRSFKUZESSKVLJDFCV2LKZFU4RCVKVLVEV2JKJBVKMSRKNKESNKLKZJVEQ2IJJLE4RSDKIZEETCKINCUGVCLIVDVERCVJVHFGR2JKZDVKVKVGJEESVK2KZIVOS2OJJFEYRKPJZBTES2SJBKVGTKTKRFESMSGIVLFGRSLJJFFKNSSJNHEYSSDIVBVIS2TJNNEIRSLK5FUKSJVI5CVKVSDJBEUMSKVJFIUWTSLJFNEKT2RJNNESRRWIRBU4USUIZMTGRCNG5BFGR2BLJCEWTCKKFDU2V2UI5GUEQKHIFNEIVKNIJIUQSKZIRATOQ2TJI2HYNRSHE2XYMT4NRYDCOBZG56DELL4KVJUI7CVKN6DEMBSGUWTANBNGAYXYMRQGI2S2MBUFUYDE7D4GQXDAMA",
          "supplier": "nuitee",
          "supplierId": 2,
          "rates": [
            {
              "rateId": "I42FUVCPJZBFOR2FGNDUWTSSKVDVSWKUJ5GVEV2HKFNEIQKOKRBUOWJUKRGVUSSXI42FURCBJZNFGR22KRCE2WSSK5GVENSEINEVUU2HIFNEIS2NIJKUOQKZLBMU2USRI5ETEVCBJZBFCR2KGZDUWM2TG5FVMSSYLFLEWVCQKJFVMR2SIQ2EOSSBKRAVCMZUI5EVURCRJUZTIS2VLJDE2V2EKNIFCWKUJ5HEEUKHGQZFIS2OKJMUOQJTIRBU4Q2JJRBFOSCNJFNFOR2JGRKEWSK2KVDVKM2TGJHFEU2IIUZFQWKVKNDUUWRWIRCU2QSTI5KVSRCHJVNFCR2BLJCECTKEGRDUMNSGIVGUUU2HIUZVQWKNJJLEONC2KRHUSMSTJI2FEVSFKJJU6RKNLJCECTKSKZDFKWKEI5GEUVCHIFIUIQKNKIZEOQKZIF6DCNRTFY3DM7BSGAZDKLJQGMWTGMBAGAZDUMBQHIYDA7CSJ4",
              "occupancyNumber": 1,
              "name": "Standard King Room",
              "maxOccupancy": 2,
              "adultCount": 2,
              "childCount": 0,
              "childrenAges": [],
              "boardType": "RO",
              "boardName": "Room Only",
              "remarks": "",
              "priceType": "commission",
              "commission": [
                {
                  "amount": 6.28,
                  "currency": "USD"
                }
              ],
              "retailRate": {
                "total": [
                  {
                    "amount": 163.66,
                    "currency": "USD"
                  }
                ],
                "suggestedSellingPrice": [
                  {
                    "amount": 191.52,
                    "currency": "USD",
                    "source": "booking.com"
                  }
                ],
                "initialPrice": [
                  {
                    "amount": 163.66,
                    "currency": "USD"
                  }
                ],
                "taxesAndFees": [
                  {
                    "included": true,
                    "description": "NYC Javits Center Fee",
                    "amount": 1.62,
                    "currency": "USD"
                  },
                  {
                    "included": true,
                    "description": "NYC Occupancy Tax",
                    "amount": 2.16,
                    "currency": "USD"
                  },
                  {
                    "included": true,
                    "description": "NY State Tax",
                    "amount": 11.88,
                    "currency": "USD"
                  },
                  {
                    "included": true,
                    "description": "NY City Tax",
                    "amount": 7.87,
                    "currency": "USD"
                  },
                  {
                    "included": false,
                    "description": "Facility Fee",
                    "amount": 43.61,
                    "currency": "USD"
                  }
                ],
                "promotions": [
                  {
                    "name": "Early booker Deal",
                    "from": "2025-11-14",
                    "to": "2025-11-27",
                    "discount": 45,
                    "discountType": "percentage",
                    "promotionCode": "",
                    "currency": "THB"
                  }
                ]
              },
              "cancellationPolicies": {
                "cancelPolicyInfos": [
                  {
                    "cancelTime": "2026-07-30 02:00:00",
                    "amount": 163.66,
                    "currency": "USD",
                    "type": "amount",
                    "timezone": "GMT"
                  }
                ],
                "hotelRemarks": [],
                "refundableTag": "RFN"
              },
              "paymentTypes": [
                "NUITEE_PAY",
                "PROPERTY_PAY"
              ],
              "perks": [
                {
                  "perkId": 10,
                  "name": "Daily breakfast for 2",
                  "amount": 40,
                  "currency": "USD",
                  "level": "HOTEL"
                },
                {
                  "perkId": 5,
                  "name": "Late check-out if available",
                  "amount": 20,
                  "currency": "USD",
                  "level": "HOTEL"
                },
                {
                  "perkId": 8,
                  "name": "Room upgrade if available",
                  "amount": 60,
                  "currency": "USD",
                  "level": "HOTEL"
                },
                {
                  "perkId": 6,
                  "name": "Early check-in if available",
                  "amount": 0,
                  "currency": "USD",
                  "level": "HOTEL"
                },
                {
                  "perkId": 2,
                  "name": "$100 Property credit",
                  "amount": 100,
                  "currency": "USD",
                  "level": "HOTEL"
                },
                {
                  "perkId": 16,
                  "name": "Free laundry service",
                  "amount": 35,
                  "currency": "USD",
                  "level": "HOTEL"
                }
              ]
            }
          ],
          "offerRetailRate": {
            "amount": 163.66,
            "currency": "USD"
          },
          "suggestedSellingPrice": {
            "amount": 191.52,
            "currency": "USD",
            "source": "booking.com"
          },
          "offerInitialPrice": {
            "amount": 163.66,
            "currency": "USD"
          },
          "priceType": "commission",
          "rateType": "standard"
        }
      ]
    }
  ],
  "guestLevel": 0,
  "sandbox": true
}

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
occupancies
object[]
required

An array of objects specifying the number of guests per room. Required.

​
currency
string
required

The currency in which the prices will be displayed.

Example:

"USD"

​
guestNationality
string
required

The guest's nationality in ISO 2-letter country code format.

Example:

"US"

​
checkin
string
required

The check-in date in YYYY-MM-DD format (ISO 8601).

Example:

"2026-07-01"

​
checkout
string
required

The check-out date in YYYY-MM-DD format (ISO 8601).

Example:

"2026-07-02"

​
hotelIds
string[]

An array of hotel IDs to search for availability and pricing. These are usually pulled from https://docs.liteapi.travel/reference/get_data-hotels.

Example:
["lp1897"]
​
timeout
integer

The maximum time in seconds before the request times out. This is when the live request for rates will cut off responses; it will take a few more ms to return the value.

Example:

6

​
maxRatesPerHotel
integer

The number of room rates to return per hotel, sorted by price (cheapest first). Set to 1 to just get the cheapest rate for each hotel, this is helpful for listing pages.

Example:

1

​
boardType
string

Filter results by board type. Example values: RO (Room Only), BB (Bed & Breakfast), HB (Half Board), etc.

Example:

"RO"

​
refundableRatesOnly
boolean

If true, only refundable rates (RFN) will be included in the response.

Example:

true

​
sort
object[]

Sorting criteria for the results. Multiple criteria can be provided, processed in order. The default sorting is by top picks. You can sort by price in ascending or descending order.

Example:
[
  {
    "field": "top_picks",
    "direction": "ascending"
  }
]
​
roomMapping
boolean

Enable room mapping to retrieve the mappedRoomId for each room. This allows you to link a rate to its specific room by combining it with hotel details, providing access to room images and additional information

Example:

true

​
hotelName
string

A case-insensitive search for a hotel's name (e.g., 'Hilton').

Example:

"Hilton"

​
countryCode
string

The country code in ISO 2-letter format (e.g., 'SG' for Singapore). Instead of using hotel IDs, you can search by country/city. This is a valid main query.

Example:

"US"

​
cityName
string

The name of the city to search for hotels in. Pairs with countryCode to do a country/city search.

Example:

"New York"

​
latitude
number

The latitude coordinate for location-based hotel searches. Instead of using hotel IDs, you can search by lat/long and a radius around that spot. This is a valid main query.

Example:

34.052235

​
longitude
number

The longitude coordinate for location-based hotel searches. Pairs with latitude to do a lat/long search.

Example:

-118.243683

​
radius
integer

The search radius in meters for location-based searches. Pairs with latitude to do a lat/long search.

Example:

5000

​
iataCode
string

The IATA code of the search location, typically an airport code. Instead of using hotel IDs, you can search by IATA code. This is a valid main query.

Example:

"LAX"

​
limit
integer

The maximum number of results to return. Defaults to 200, max allowed is 5000.

Example:

10

​
offset
integer

The number of results to skip for pagination. This paginates the passed hotels not the results returned so the actual returned results will vary.

Example:

0

​
aiSearch
string

AI-powered hotel search based on a natural language query. Uses semantic search to find hotels matching the query intent. Examples: 'Romantic getaway with Italian vibes in London near the London Eye', 'hotels near Paris'. This is a valid main query.

Example:

"Romantic getaway with Italian vibes in London near the London Eye"

​
minReviewsCount
integer

The minimum number of reviews a hotel must have to be included in results. This is a filter on top of the main query.

Example:

100

​
minRating
number

The minimum rating (on a scale of 0-5) required for hotels in search results. This is a filter on top of the main query.

Example:

4.5

​
zip
string

The zip code of the search location. This is a filter on top of the main query.

Example:

"10012"

​
placeId
string

The unique Place ID of the search location. Instead of using hotel IDs, pass a Place ID to get all the hotels in the specified region. This is a valid main query.

Example:

"ChIJYeZuBI9YwokRjMDs_IEyCwo"

​
starRating
number[]

An array of hotel star ratings to include. Ratings are rounded to the nearest half-star (e.g., [3.5, 4.0, 4.5, 5.0]). This is a filter on top of the main query.

Example:
[4, 5]
​
hotelTypeIds
number[]

An array of hotel type IDs to filter the search results. This is a filter on top of the main query.

Example:
[201, 204, 208]
​
chainIds
number[]

An array of hotel chain IDs to filter the search results. This is a filter on top of the main query.

Example:
[14675, 14677]
​
facilities
number[]

An array of facility IDs. Results will include hotels with at least one of these facilities by default. This is a filter on top of the main query.

Example:
[1, 2, 3]
​
strictFacilityFiltering
boolean

If enabled, only hotels with all specified facilities will be returned.

Example:

true

​
stream
boolean

If true, enables streaming mode where response data is sent incrementally instead of as a single payload.

Example:

false

​
advancedAccessibilityOnly
boolean

If true, only hotels with advanced accessibility features will be returned.

Example:

true

​
feed
string

Which feed to use when searching for rates. This applies only to accounts with multiple feeds enabled

Example:

"custom_feed"

​
includeHotelData
boolean

If true, includes hotel data (name, main photo, address, rating) in the response even when searching by direct hotel IDs. By default, hotel data is only included when searching by filters (e.g., using aiSearch, countryCode, cityName, etc.). Setting this to true enables hotel data inclusion for all search types.

Example:

true

Response

OK

​
data
object[]
​
guestLevel
integer

Used with loyalty programs to determine the guests level of cost reduction.

​
sandbox
boolean

Indicates if the request was made in a sandbox (test) environment