Monthly Availability Grid API

Overview

Generates a monthly calendar matrix grid with day-by-day room availability, blackout status, prices per night, and statistics.

• Endpoint: /api/availability/monthly
• Method: GET

Query Parameters

Parameter	Type	Required	Description
hotelId	String (UUID)	Conditional	Target hotel ID
hotelRoomId	String (UUID)	Conditional	Target room ID
month	Number	Yes	Month number (1 - 12)
year	Number	Yes	Year (2020 - 2100)

Response Example (200 OK)

{
  "success": true,
  "data": {
    "year": 2026,
    "month": 10,
    "totalDays": 31,
    "stats": {
      "totalAvailableDays": 29,
      "totalClosedDays": 2,
      "averagePricePerNight": 4750.00
    },
    "calendar": [
      {
        "day": 1,
        "date": "2026-10-01",
        "dayType": "WEEKDAY",
        "availableRooms": 8,
        "pricePerNight": 4500,
        "isClosed": false,
        "isAvailable": true,
        "minimumStayNights": 1
      }
    ]
  },
  "message": "Monthly availability grid fetched successfully"
}