SEseats

Get Availability

Bulk availability: every upcoming check-in date with a rate for a program or a set of hotels, one object per hotel, check-in date and stay length (1 to 5 nights), with the same filters as the Explore pages. Only dates retrieved within the last 21 days are returned. Use this for broad scans; use Search for an area and date range.

get/availability

Request

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

Query parameters

sourcestring

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

hotel_idstring

Only these hotels. Comma-delimited if multiple, at most 50. Required unless source is given.

start_datestring

Earliest check-in date, YYYY-MM-DD. Dates bound the check-in date, not the whole stay; use nights for the stay length.

end_datestring

Latest check-in date, YYYY-MM-DD.

nightsinteger

Only stays of exactly this many nights, 1 to 5. Omit for every stay length.

brandstring

Only hotels with these brand codes. Comma-delimited if multiple.

categorystring

Only hotels in these award categories. Comma-delimited if multiple.

countrystring

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

rate_type'award' | 'cash' | 'any'

Which kind of rate a row must offer: award (points), cash, or any.

room_type'standard' | 'suite' | 'any'

Which room class must offer it: standard, suite, or any. Also scopes max_points, min_cpp and the lowest_* orderings to that class.

max_pointsinteger

Only rows with an award at or below this many points.

min_cppnumber

Only rows whose award is worth at least this many US cents per point (a cash rate must have been seen).

order_by'arrival_date' | 'lowest_award' | 'lowest_cash' | 'last_checked'

arrival_date (soonest first), lowest_award (cheapest points first), lowest_cash (cheapest cash first, compared in USD), or last_checked (most recently retrieved first). Ties are broken by id so pages are stable.

include_hotelboolean

Embed the hotel object and booking link on each row. Set to false for a smaller payload when you already have the hotels.

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 500.

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": "2S8Cm9dHORWWKpoCkxfRkZa0e5l",
      "hotel_id": "2PPrELk9WcfJaNREWEPXypvhXAD",
      "hotel": {
        "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
      },
      "source": "hyatt",
      "arrival_date": "2026-11-21",
      "departure_date": "2026-11-22",
      "num_nights": 1,
      "cash_currency_code": "USD",
      "standard_award_available": true,
      "standard_award_cost": 30000,
      "standard_cash_available": true,
      "standard_cash_cost": 68500,
      "standard_cpp": 2.28,
      "booking_link": {
        "label": "Book via World of Hyatt",
        "url": "https://www.hyatt.com/shop/rooms/tyoph?checkinDate=2026-11-21&checkoutDate=2026-11-22&rooms=1&adults=1&kids=0&rate=Standard&rateFilter=woh&utm_source=roomsaero"
      },
      "rooms": [
        {
          "source": "hyatt",
          "room_code": "KING",
          "name": "1 King Bed",
          "award_cost": 30000,
          "cash_cost": 68500,
          "cash_cost_currency": "USD",
          "arrival_date": "2026-11-21",
          "departure_date": "2026-11-22",
          "num_nights": 1
        }
      ]
    }
  ],
  "count": 2
}

Changes

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