Get a hotel calendar
Compare cached nightly points and cash rates, room types, and redemption values for a specific hotel.
POST
https://apisv2.awardtoolapi.com/api/hotel_calendarExample 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.