---
title: "Retrieve a list of hotels"
method: GET
path: "/data/hotels"
tags: ["Hotels"]
---

# Retrieve a list of hotels

`GET /data/hotels`

## Overview

Search and retrieve hotel listings based on various criteria. Get hotel metadata including names, addresses, ratings, amenities, and images for display in your application.

## When to Use

- **Hotel listings** - Display hotel search results
- **Location-based search** - Find hotels by city, coordinates, or Place ID
- **Hotel discovery** - Browse hotels in specific areas
- **Metadata retrieval** - Get hotel information for display

## What You Get

- **Hotel list** - Matching hotels with complete metadata
- **Basic information** - Names, addresses, ratings, and locations
- **Amenities** - Available facilities and features
- **Images** - Hotel photos for display
- **Identifiers** - Hotel IDs for use in rate searches

## Search Options

- **By city** - Search hotels in a specific city
- **By coordinates** - Find hotels near latitude/longitude with radius
- **By Place ID** - Get hotels within a specific place boundary
- **By hotel IDs** - Retrieve specific hotels by their IDs

## Quick Start

Provide search criteria (city, coordinates+radius, placeId, or hotelIds). Returns matching hotels with complete metadata.

## Query parameters

- `countryCode` string
- `cityName` string
- `hotelName` string
- `offset` integer
- `limit` integer
- `lastUpdatedAt` string
- `longitude` number
- `latitude` number
- `radius` integer
- `aiSearch` string
- `timeout` number, float
- `zip` string
- `minRating` number, float
- `minReviewsCount` number
- `facilityIds` string
- `hotelTypeIds` string
- `chainIds` string
- `strictFacilitiesFiltering` boolean
- `starRating` string
- `placeId` string
- `language` string
- `hotelIds` string
- `advancedAccessibilityOnly` boolean

## Response `200`

OK

- object
  - `data` object[]
    - `id` string, required — Unique identifier of the hotel
    - `name` string, required — Name of the hotel
    - `hotelDescription` string — A brief description of the hotel and its facilities
    - `currency` string — The currency code used for hotel pricing (e.g., USD, EUR)
    - `country` string, required — The country where the hotel is located
    - `city` string, required — The city where the hotel is situated
    - `latitude` number, required — The latitude coordinate of the hotel's location
    - `longitude` number, required — The longitude coordinate of the hotel's location
    - `address` string — The street address of the hotel
    - `zip` string — The postal code of the hotel
    - `main_photo` string — The main image representing the hotel
    - `thumbnail` string — A smaller version of the main photo used for previews
    - `stars` number — The hotel's star rating (e.g., 3, 4, 5 stars)
    - `hotelTypeId` number — The unique identifier for the hotel's category or type
    - `chainId` number — The unique identifier of the hotel chain
    - `chain` string — The name of the hotel chain, if applicable (e.g., Hilton, Marriott).
    - `accessibilityAttributes` object — A compact representation of the hotel's accessibility features.
      - `attributes` string[], required — List of attributes representing boolean fields that are true.
      - `showerChair` string, nullable — Information about the availability of a shower chair.
      - `entranceType` string, nullable — Type of entrance, e.g., automatic or manual.
      - `petFriendly` string, required — Indicates if the hotel is pet-friendly.
      - `rampAngle` number, float, required — The angle of the ramp in degrees.
      - `rampLength` number, float, required — The length of the ramp in meters.
      - `entranceDoorWidth` integer, required — Width of the entrance door in centimeters.
      - `roomMaxGuestsNumber` integer, required — Maximum number of guests allowed in the room.
      - `distanceFromTheElevatorToTheAccessibleRoom` number, float, required — Distance from the elevator to the accessible room in meters.
    - `rohId` integer — Room of House ID - unique identifier for the hotel property.
    - `deletedAt` string — Timestamp indicating when hotel is deleted in our system
    - `score` number, float — Similarity score (0.0-1.0) indicating how well the hotel name matches the search query when searching by placeId. Higher scores indicate better matches. Only present when placeId parameter is used.
    - `rating` number, float — The average guest rating for the hotel (e.g., 8.5 out of 10)
    - `reviewCount` integer — The total number of guest reviews for the hotel
    - `facilityIds` integer[] — Array of facility IDs available at the hotel (e.g., [1, 2, 3] representing WiFi, Pool, Gym)
  - `hotelIds` string[] — An array of unique hotel identifiers that match the specified filters or query parameters, allowing quick reference to specific hotels.
  - `total` integer — The total number of hotels retrieved based on the applied filters or query parameters.
  - `place` object — Place information used in the search. Only present when placeId parameter is used.
    - `placeId` string — The place ID used in the search
    - `displayName` string — The display name of the place (e.g., 'Marriott New York JFK Airport')
    - `addressComponents` object[] — A list of address components, each representing a part of the address such as country, city, or postal code.
      - `languageCode` string — The language code for the address component (e.g., 'en', 'en-US').
      - `longText` string — The full text of the address component (e.g., 'France').
      - `shortText` string — The abbreviated or short text for the address component (e.g., 'FR').
      - `types` string[] — A list of types describing the address component (e.g., 'country', 'political').
    - `location` object — The geographic coordinates of the place.
      - `latitude` number — The latitude of the location.
      - `longitude` number — The longitude of the location.
    - `viewport` object — The recommended viewport for displaying the place, defined by high and low latitude/longitude bounds.
      - `high` object — The northeast corner of the viewport.
        - `latitude` number — The latitude of the high (northeast) corner.
        - `longitude` number — The longitude of the high (northeast) corner.
      - `low` object — The southwest corner of the viewport.
        - `latitude` number — The latitude of the low (southwest) corner.
        - `longitude` number — The longitude of the low (southwest) corner.
    - `types` string[] — A list of place types (e.g., 'lodging', 'hotel', 'establishment').

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

[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)