API Documentation - PointsYeah

POSTHotel Calendar

Retrieve daily hotel availability for a specific property over a given month. Returns points, cash price, and room type for each check-in date.

POST https://ai-api.pointsyeah.com/hotel/explorer/calendar/v2

Parameters

ParameterValue

property_idnumberrequired

Hotel property ID (from Hotel Search results).

monthstringrequired

Month to query in YYYY-MM format.Default: 2026-07

fhrboolean

Query Fine Hotels & Resorts calendar data.Default: false

Try It

X-API-Key

curl --request POST \
  --url https://ai-api.pointsyeah.com/hotel/explorer/calendar/v2 \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{"property_id":12345,"month":"2026-07"}'

Response

{
  "code": 0,
  "success": true,
  "data": {
    "lowest_cash_price": 0,
    "hotel": {
      "code": "STLRL",
      "name": "Residence Inn St. Louis Clayton",
      "program": "marriott"
    },
    "months": [
      {
        "points": 0,
        "cash_price": 0,
        "room_type": "standard",
        "cash_room_type": "standard",
        "points_room_type": "standard",
        "checkin_date": "2026-07-01"
      },
      {
        "points": 0,
        "cash_price": 0,
        "room_type": "standard",
        "cash_room_type": "standard",
        "points_room_type": "standard",
        "checkin_date": "2026-07-02"
      }
    ]
  }
}