Availability Rules API

Overview

Configures seasonal date-range availability rules, day types (WEEKDAY, WEEKEND, PUBLIC_HOLIDAY), minimum stay requirements, and nightly pricing overrides for a hotel or room.

• Endpoint: /api/availability/rules
• Method: POST (Create) / GET (List)

Request Body Schema (Create - POST)

Field	Type	Required	Description
hotelId	String (UUID)	Conditional	Target hotel ID
hotelRoomId	String (UUID)	Conditional	Target room ID
dayType	Enum	No	WEEKDAY, WEEKEND, PUBLIC_HOLIDAY (Default: WEEKDAY)
availableFrom	String	Yes	Start date (YYYY-MM-DD)
availableUntil	String	No	End date (YYYY-MM-DD)
minimumStayNights	Number	No	Minimum stay nights (Default: 1)
pricePerNight	Number	No	Overridden nightly price
availableRoomsCount	Number	No	Overridden room capacity

Request Body Example

{
  "hotelId": "7a8b9c1d-2e3f-4a5b-6c7d-8e9f0a1b2c3d",
  "dayType": "WEEKEND",
  "availableFrom": "2026-10-01",
  "availableUntil": "2026-12-31",
  "minimumStayNights": 2,
  "pricePerNight": 5500.00
}

Response Example (201 Created)

{
  "success": true,
  "data": {
    "id": "rule_99887766",
    "hotelId": "7a8b9c1d-2e3f-4a5b-6c7d-8e9f0a1b2c3d",
    "dayType": "WEEKEND",
    "minimumStayNights": 2,
    "pricePerNight": "5500.00",
    "active": true
  },
  "message": "Availability rule created successfully"
}