Skip to main content
GET
/
hotels
/
list
Retrieve a list of hotels
curl --request GET \
  --url https://api.staging.rovemiles.com/functions/v1/hotels/list \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "RM42853",
      "name": "The Rove Grand Hotel",
      "hotelDescription": "Located in the heart of downtown, The Rove Grand Hotel offers luxury accommodations with stunning city views. This 5-star property features a rooftop pool, full-service spa, and three signature restaurants.",
      "currency": "USD",
      "country": "US",
      "city": "New York",
      "latitude": 40.7128,
      "longitude": -74.006,
      "address": "123 Broadway",
      "zip": "10007",
      "main_photo": "https://static.rovemiles.com/hotels/RM42853_main.jpg",
      "thumbnail": "https://static.rovemiles.com/hotels/RM42853_thumb.jpg",
      "hotelTypeId": 204,
      "chainId": 14675,
      "chain": "Rove Hotels",
      "stars": 5,
      "facilityIds": [
        1,
        2,
        3,
        5,
        8,
        12,
        15,
        18
      ],
      "accessibilityAttributes": {
        "attributes": [
          "entranceLeveled",
          "restaurantWheelchairAccessible",
          "poolAccessible"
        ],
        "showerChair": "available",
        "entranceType": "automatic",
        "petFriendly": "service animals only",
        "entranceDoorWidth": 36,
        "roomMaxGuestsNumber": 4,
        "distanceFromTheElevatorToTheAccessibleRoom": 25
      }
    },
    {
      "id": "RM36721",
      "name": "Rove Boutique Suites",
      "hotelDescription": "Rove Boutique Suites offers stylish apartment-style accommodations in a historic downtown building. Each suite features a fully equipped kitchen, living area, and premium bedding.",
      "currency": "USD",
      "country": "US",
      "city": "New York",
      "latitude": 40.742,
      "longitude": -73.989,
      "address": "456 Park Avenue",
      "zip": "10022",
      "main_photo": "https://static.rovemiles.com/hotels/RM36721_main.jpg",
      "thumbnail": "https://static.rovemiles.com/hotels/RM36721_thumb.jpg",
      "hotelTypeId": 201,
      "chainId": 14675,
      "chain": "Rove Hotels",
      "stars": 4,
      "facilityIds": [
        1,
        2,
        7,
        9,
        12
      ],
      "accessibilityAttributes": {
        "attributes": [
          "entranceLeveled",
          "cabinUnderSink"
        ],
        "entranceType": "manual",
        "petFriendly": "all pets welcome",
        "entranceDoorWidth": 32,
        "roomMaxGuestsNumber": 6,
        "distanceFromTheElevatorToTheAccessibleRoom": 15
      }
    },
    {
      "id": "RM51908",
      "name": "Rove Express Hotel",
      "hotelDescription": "Perfect for business travelers, Rove Express Hotel offers convenient accommodations with free high-speed WiFi, 24-hour business center, and complimentary breakfast.",
      "currency": "USD",
      "country": "US",
      "city": "New York",
      "latitude": 40.7589,
      "longitude": -73.9851,
      "address": "789 5th Avenue",
      "zip": "10019",
      "main_photo": "https://static.rovemiles.com/hotels/RM51908_main.jpg",
      "thumbnail": "https://static.rovemiles.com/hotels/RM51908_thumb.jpg",
      "hotelTypeId": 204,
      "chainId": 14675,
      "chain": "Rove Hotels",
      "stars": 3.5,
      "facilityIds": [
        1,
        2,
        4,
        9
      ],
      "accessibilityAttributes": {
        "attributes": [
          "entranceLeveled",
          "restaurantWheelchairAccessible"
        ],
        "entranceType": "automatic",
        "petFriendly": "service animals only",
        "entranceDoorWidth": 34,
        "roomMaxGuestsNumber": 4,
        "distanceFromTheElevatorToTheAccessibleRoom": 20
      }
    }
  ],
  "hotelIds": [
    "RM42853",
    "RM36721",
    "RM51908"
  ],
  "total": 129
}

Authorizations

​
Authorization
string
header
required

API key for authentication. Add your API key to the Authorization header with this format: 'Bearer your_api_key_here'

Query Parameters

​
placeId
string

Place ID obtained from the /data/places search endpoint

​
countryCode
string

Country code in ISO-2 format (e.g., 'US')

Pattern: ^[A-Z]{2}$
​
cityName
string

Name of the city

​
hotelName
string

Name of the hotel (loose match, case-insensitive)

​
latitude
number<float>

Latitude coordinate for location-based search

​
longitude
number<float>

Longitude coordinate for location-based search

​
radius
integer

Search radius in meters (minimum 1000m)

Required range: x >= 1000
​
limit
integer
default:200

Maximum number of hotels to return

Required range: 1 <= x <= 5000
​
offset
integer
default:0

Number of results to skip for pagination

Required range: x >= 0
​
minRating
number<float>

Minimum guest rating (1.0-5.0)

Required range: 1 <= x <= 5
​
minReviewsCount
integer

Minimum number of reviews a hotel must have

Required range: x >= 0
​
starRating
string

Comma-separated list of star ratings (e.g., '3.5,4.0,5.0')

​
facilities
string

Comma-separated list of facility IDs

​
hotelTypeIds
string

Comma-separated list of hotel type IDs

​
chainIds
string

Comma-separated list of hotel chain IDs

​
strictFacilityFiltering
boolean
default:false

If true, only hotels with all specified facilities will be returned

Response

OK

​
data
object[]
​
hotelIds
string[]

List of all hotel IDs returned in the response

​
total
integer

Total number of hotels matching the search criteria