API Reference
Free SignupLogin to DashboardCustomer Support

Retrieve rates for hotels

post
https://api.liteapi.travel/v3.0/hotels/rates

Overview

Search for hotel rates and availability across multiple hotels. This is your primary endpoint for finding bookable hotel rooms with real-time pricing.

When to Use

  • Display hotel listings with prices on your search results page
  • Show detailed rate options for specific hotels users are viewing
  • Support multi-room bookings for families or groups
  • Filter hotels by location, amenities, ratings, or AI-powered semantic search

What You Get

  • Real-time rates with availability and pricing
  • Multiple room options per hotel, sorted by price
  • Complete booking details including cancellation policies, meal plans, and room types
  • Hotel information (name, photos, address, ratings) when searching by filters

Key Features

  • Multiple search methods: Search by hotel IDs, city/country, coordinates, Place ID, IATA code, or natural language (AI search)
  • Flexible filtering: Filter by star rating, facilities, hotel chains, accessibility, and more
  • Multi-room support: Book multiple rooms with different guest configurations in one request
  • Performance optimized: Default limit of 200 hotels (expandable to 5,000), recommended timeout of 6-12 seconds

Quick Start

Required fields: checkin, checkout, currency, guestNationality, occupancies, plus one location method (hotel IDs, city/country, coordinates, Place ID, or IATA code)

Tip: When searching by filters (like aiSearch or cityName), hotel data is automatically included. For direct hotel ID searches, set includeHotelData=true to include hotel names and photos.

Body Params
hotelIds
array of strings

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

hotelIds
occupancies
array of objects
required

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

occupancies*
string
required

The currency in which the prices will be displayed.

string
required

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

string
required

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

string
required

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

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.

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.

string

Filter results by board type(s). Can be a single value (e.g., 'BB') or comma-separated values (e.g., 'BB,BB1,BB2') for OR logic. Example values: RO (Room Only), BB (Bed & Breakfast), HB (Half Board), BB1, BB2, BB3, etc.

boolean

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

roomAmenities
array of numbers

Legacy room-level amenity filter. Only rates from rooms that match the specified amenities will be returned. Use amenityFilterLogic to control flat AND/OR behavior. If roomAmenitiesFilter is provided, it takes precedence over this field.

roomAmenities
string

Grouped room-level amenity filter. Use '-' for OR within a group and ',' for AND across groups. Example: '1-2,3-4' means (1 OR 2) AND (3 OR 4). If provided, this field takes precedence over roomAmenities and amenityFilterLogic.

string
enum

Legacy logic applied to roomAmenities. 'AND': room must have all specified amenities. 'OR': room must have at least one specified amenity. Ignored when roomAmenitiesFilter is provided.

Allowed:
bedTypes
array of strings

Filter results by bed types extracted from room names. Only rates from rooms matching the specified bed types will be returned. Example values: 'double', 'twin', 'king', 'queen', 'single'.

bedTypes
sort
array of objects

Sorting criteria for the results. Multiple criteria can be provided, processed in order. The default sorting is by top picks (weighted by search popularity, review quality, and content completeness). Use 'revenue' to sort by historical booking value and monetary performance.

sort
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

string

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

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.

string

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

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.

number

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

integer

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

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.

integer

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

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.

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.

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.

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.

string

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

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.

starRating
array of numbers

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.

starRating
hotelTypeIds
array of numbers

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

hotelTypeIds
chainIds
array of numbers

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

chainIds
facilities
array of numbers

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.

facilities
boolean

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

boolean

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

boolean

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

string

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

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.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Updated about 1 month ago

What’s Next
Language
Credentials
Header
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
text/event-stream
Updated about 1 month ago 
What’s Next