Get Hotels

get

https://rooms.aero/partnerapi/hotels

Browse the hotel directory.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Lists every property rooms.aero tracks, ordered by name. Narrow it by id or internal_id (the program's own property code), program, country, state, city, brand code, award category, or a case-insensitive name search. There is no per-hotel endpoint: to fetch one hotel, pass its id. Each hotel carries lowest_award, the cheapest award seen on any upcoming date in the last two weeks, and the share of checked dates with any award available.

Pages hold up to 1,000 hotels. To load a whole program, page with take=1000 and follow more_url.

Query Params

string

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

internal_id

string

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.

source

string

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

country

string

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

state

string

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

city

string

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

brand

string

Only these brand codes. Comma-delimited if multiple.

200200

400Invalid parameter

401Missing, unknown or unsubscribed API key

429Daily quota exhausted