Get Availability Details

One availability with its hotel, a booking link and every room type seen on that date, cheapest award first.

get/availability/{id}

Request

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

Path parameters

idstring required

The availability id, from Get Availability.

Response

200

idstring

Identifier for the availability. Use it with Get Availability Details.

hotel_idstring

The hotel.

sourcestring

The loyalty program key.

arrival_datestring

Check-in date. Formatted YYYY-MM-DD.

departure_datestring

Check-out date. Formatted YYYY-MM-DD.

num_nightsinteger

Length of stay.

cash_currency_codestring

ISO 4217 code for every cash cost on this object. Cash costs are in the currency's minor unit (cents) for the whole stay.

standard_award_availableboolean

Whether a standard room was bookable with points.

standard_award_costinteger

Cheapest standard room award, in points.

standard_cash_availableboolean

Whether a standard room was bookable for cash.

standard_cash_costinteger

Cheapest standard room cash rate, in the minor unit of cash_currency_code.

standard_cppnumber

Cash value of each point for the standard room, in US cents, when both rates were seen; 0 otherwise.

suite_award_availableboolean

Whether a suite was bookable with points.

suite_award_costinteger

Cheapest suite award, in points.

suite_cash_availableboolean

Whether a suite was bookable for cash.

suite_cash_costinteger

Cheapest suite cash rate, in the minor unit of cash_currency_code.

suite_cppnumber

Cash value of each point for the suite, in US cents; 0 when either rate is missing.

last_checked_atstring date-time

When this date's rates were last retrieved. RFC 3339 timestamp.

created_atstring date-time

When this date was first seen. RFC 3339 timestamp.

Example response

{
  "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
    }
  ]
}

Changes

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