Check Stay Availability API

Overview

Validates check-in to check-out stay dates for requested rooms count and guest capacity, calculating total stay price and nightly breakdown.

• Endpoint: /api/availability/check
• Method: POST / GET

Request Body / Query Schema

Field	Type	Required	Description
hotelId	String (UUID)	Yes	Target hotel ID
hotelRoomId	String (UUID)	No	Target specific room ID
checkIn	String	Yes	Check-in date (YYYY-MM-DD)
checkOut	String	Yes	Check-out date (YYYY-MM-DD)
rooms	Number	No	Requested rooms count (Default: 1)
guests	Number	No	Guest count (Default: 1)

Response Example (200 OK)

{
  "success": true,
  "data": {
    "checkIn": "2026-10-01",
    "checkOut": "2026-10-05",
    "stayNights": 4,
    "requestedRooms": 1,
    "availableCount": 1,
    "availableRooms": [
      {
        "roomId": "11223344-5566-7788-9900-aabbccddeeff",
        "roomType": "DELUXE",
        "roomName": "Ocean Deluxe Suite",
        "maxOccupancy": 3,
        "stayNights": 4,
        "totalPrice": 18000,
        "averagePricePerNight": 4500,
        "nightlyBreakdown": []
      }
    ]
  },
  "message": "Stay availability check completed"
}