Browse API endpoints

Get a hotel calendar

Compare cached nightly points and cash rates, room types, and redemption values for a specific hotel.

POSThttps://apisv2.awardtoolapi.com/api/hotel_calendar

Example request

Shell
curl --request POST \
  'https://apisv2.awardtoolapi.com/api/hotel_calendar' \
  --header 'Content-Type: application/json' \
  --data '{
  "hotel_id": "hyatt_kauai",
  "api_key": "YOUR_API_KEY"
}'

Read the date keys in the first item of data. Each date can contain several room types or rate plans.

Cash-only offers may omit points_rate and point_value or return null for those fields.

Request body

hotel_idstring · Required
Full AwardTool property id from the hotel list, including the brand prefix.
api_keystring · Required
Your AwardTool API key.

Example response

JSON · response excerpt
{
  "status": 200,
  "hotel_info": {
    "id": "hyatt_kauai",
    "name": "Grand Hyatt Kauai Resort & Spa"
  },
  "hide_data": false,
  "data": [
    {
      "2027-02-15": [
        {
          "avail_date": "2027-02-15",
          "cash_price": "675",
          "points_rate": 30000,
          "point_value": "2.25",
          "room_type": "1 King Bed",
          "rate_plan": "Standard Room"
        }
      ]
    }
  ]
}

Response fields

data[0]
Check-in dates mapped to lists of nightly room rates.
points_rate
Points required for one award night on the listed rate plan.
cash_price, point_value
Nightly cash price and estimated value in cents per point.
created_at, res_link
Time the rate was collected and the property's booking link when available.
hotel_info
Property details and pricing summaries.
hide_data
True when the response withholds the calendar data.

Errors

400
Supply the complete AwardTool id from the hotel list, including its brand prefix.
View original API reference