SEseats

Get Hotels

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.

get/hotels

Request

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

Query parameters

idstring

Only these hotels, by rooms.aero id. Comma-delimited if multiple, at most 100.

internal_idstring

Only these hotels, by the program's own property code (Hilton ctyhocn, Hyatt spirit code, Marriott property code, and so on). Comma-delimited if multiple, at most 100. Combine with source, since codes are only unique within a program.

sourcestring

Loyalty program key(s), comma-delimited if multiple, such as "hyatt,hilton". The keys are listed on the Concepts page.

countrystring

Only hotels in these countries, by display name as shown on rooms.aero (for example "United States", "Japan"). Comma-delimited if multiple.

statestring

Only hotels in these states or regions. Comma-delimited if multiple.

citystring

Only hotels in these cities. Comma-delimited if multiple.

brandstring

Only these brand codes. Comma-delimited if multiple.

categorystring

Only these award categories. Comma-delimited if multiple.

searchstring

Case-insensitive substring match on the hotel name.

skipinteger

How many results to skip. Pagination is skip/take: request the next page with skip = skip + take, or follow more_url.

takeinteger

Maximum results to return. Must be between 1 and 1000.

Response

200

countinteger

Number of items in this response.

has_moreboolean

Whether another page exists.

more_urlstring

URL of the next page. Omitted on the last page.

Example response

{
  "data": [
    {
      "id": "2PPrELk9WcfJaNREWEPXypvhXAD",
      "source": "hyatt",
      "program": "World of Hyatt",
      "name": "Park Hyatt Tokyo",
      "brand": "park",
      "award_category": "7",
      "address": "3-7-1-2 Nishi Shinjuku, Shinjuku-Ku",
      "city": "Tokyo",
      "country": "Japan",
      "latitude": 35.6852,
      "longitude": 139.6891,
      "image_url": "https://assets.hyatt.com/content/dam/hyatt/hyattdam/images/2018/03/02/1141/Park-Hyatt-Tokyo-P011-Exterior.jpg",
      "internal_id": "tyoph",
      "open": true,
      "url": "https://rooms.aero/hyatt/hotel/2PPrELk9WcfJaNREWEPXypvhXAD",
      "lowest_award": 30000,
      "standard_award_availability_percent": 41,
      "standard_award_availability_window_days": 90
    }
  ],
  "count": 2
}

Changes

No recorded changes to this operation across all 1 revision of this API.