Daily Availability Breakdown API

Overview

Retrieves date-wise room availability breakdown stats including total room capacity, booked counts, price per night, day type (Weekday, Weekend, Public Holiday), and blackout status.

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

Query Parameters

Parameter	Type	Required	Description
hotelId	String (UUID)	Conditional	Target hotel ID
hotelRoomId	String (UUID)	Conditional	Target room ID (Must specify hotelId or hotelRoomId)
date	String	Yes	Target date (YYYY-MM-DD)

Response Example (200 OK)

{
  "success": true,
  "data": {
    "date": "2026-10-01",
    "summary": {
      "totalCapacity": 10,
      "totalAvailableRooms": 8,
      "totalBookedRooms": 2,
      "isFullyClosed": false
    },
    "rooms": [
      {
        "date": "2026-10-01",
        "hotelId": "7a8b9c1d-2e3f-4a5b-6c7d-8e9f0a1b2c3d",
        "hotelName": "Grand Palace Resort & Spa",
        "hotelRoomId": "11223344-5566-7788-9900-aabbccddeeff",
        "roomType": "DELUXE",
        "roomName": "Ocean Deluxe Suite",
        "dayType": "WEEKDAY",
        "totalCapacity": 10,
        "bookedCount": 2,
        "blockedCount": 0,
        "availableRooms": 8,
        "pricePerNight": 4500,
        "minimumStayNights": 1,
        "isClosed": false,
        "isPast": false,
        "isAvailable": true
      }
    ]
  },
  "message": "Daily availability fetched successfully"
}