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)
dayOfWeek	Number (Integer)	No	Specific day of week (0=Sunday to 6=Saturday)
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",
  "dayOfWeek": 6,
  "availableFrom": "2026-10-01",
  "availableUntil": "2026-12-31",
  "minimumStayNights": 2,
  "pricePerNight": 5500.00
}

Delete Availability Rule (POST /api/availability/rules/delete)

Overview

Deactivates an availability rule by setting active: false.

Request Body Schema

Field	Type	Required	Description
id	String (UUID)	Conditional	Rule ID to deactivate
ruleId	String (UUID)	Conditional	Alias for rule ID

Request Body Example

{
  "id": "rule_99887766"
}

Response Example (200 OK)

{
  "success": true,
  "data": {
    "id": "rule_99887766",
    "active": false
  },
  "message": "Availability rule deleted successfully"
}