---
title: "Get Hotels"
method: GET
path: "/hotels"
---

# Get Hotels

`GET /hotels`

## Request

- Base URL: `https://rooms.aero/partnerapi`
- URL: `https://rooms.aero/partnerapi/hotels`
- Auth: API key in header `Partner-Authorization`

The hotel directory: every property rooms.aero tracks, ordered by name, optionally narrowed by id, program, location, brand, award category or a name search. There is no per-hotel endpoint; pass id=<hotel id> to fetch one hotel.

## Query parameters

- `id` string
- `internal_id` string
- `source` string
- `country` string
- `state` string
- `city` string
- `brand` string
- `category` string
- `search` string
- `skip` integer
- `take` integer

## Response `200`

200

- HotelList: A page of hotels.
  - `data` Hotel[]
    - `id` string: rooms.aero's identifier for the hotel. Use it as hotel_id on the other endpoints.
    - `source` string: The loyalty program key. The keys are listed on the Concepts page.
    - `program` string: The loyalty program's display name.
    - `name` string: Hotel name.
    - `brand` string: Program-specific brand code. The Concepts page maps codes to names.
    - `award_category` string: Program-specific award category, for programs with an award chart. Empty otherwise.
    - `address` string: Street address as published by the program.
    - `city` string: City.
    - `state` string: State, province or region; may be empty.
    - `country` string: Country, as a display name.
    - `latitude` number: Latitude in decimal degrees.
    - `longitude` number: Longitude in decimal degrees.
    - `image_url` string: A representative photo, when the program publishes one.
    - `description` string: Short description from the program; may be empty.
    - `internal_id` string: The program's own property code (Hilton ctyhocn, Hyatt spirit code, Marriott property code, and so on).
    - `open` boolean: Whether the property is open.
    - `url` string: The hotel's page on rooms.aero.
    - `lowest_award` integer, nullable: The cheapest award, in points, seen for any upcoming date in the last two weeks. Null when none is known. Populated by Get Hotels and Search; omitted from availability rows.
    - `standard_award_availability_percent` integer, nullable: Share of checked upcoming dates with any award available, over standard_award_availability_window_days. Null until enough dates have been checked.
    - `standard_award_availability_window_days` integer, nullable: The window the percentage was measured over.
    - `standard_award_availability_updated_at` string, date-time, nullable: When the percentage was last recomputed. RFC 3339 timestamp.
    - `last_checked_at` string, date-time, nullable: When the property's rates were last retrieved. Null if never. RFC 3339 timestamp.
    - `created_at` string, date-time: When rooms.aero started tracking the hotel. RFC 3339 timestamp.
    - `updated_at` string, date-time: When the hotel record last changed. RFC 3339 timestamp.
  - `count` integer: Number of items in this response.
  - `has_more` boolean: Whether another page exists.
  - `more_url` string: URL of the next page. Omitted on the last page.

## Other responses

- `400`: Invalid parameter
- `401`: Missing, unknown or unsubscribed credentials: missing_partner_key, bad_partner_key, bad_partner_token, invalid_scope or user_subscription_expired
- `429`: Daily quota exhausted

---

[API](https://skmtc.dev/seats/apis/rooms-api.md) - [All operations](https://skmtc.dev/seats/apis/rooms-api/llms.txt) - [OpenAPI document](https://skmtc.dev/seats/apis/rooms-api/revisions/e164f8ea0b28?raw)