Prices
Prices are never stored locally. They are returned live within the search response, nested inside the room and rate plan structure.
Price Structure
Prices are nested deeply within the PropertyDetailsDTO response:
Nesting Structure
PropertyDetailsDTO
└── roomDTOList
└── RoomDTO
└── ratePlansDTOList
└── RatePlansDTO
└── roomTypeAvailabilityDTOList
└── RoomTypeAvailabilityDTO
├── date — the calendar night
├── price — price for that night
├── total_rooms — rooms available
└── isClosed — room closed on that date
Each RoomTypeAvailabilityDTO entry covers one calendar night. The total price for a stay is the sum of the price field across all nights in the stay period.
Bookability Rules
A night is only bookable when all three conditions are met:
isClosed is false
The room type is not blocked on this date
price > 0
A valid price is set for this night
total_rooms > 0
At least one room is still available
Additional constraints from RatePlansDTO
RatePlansDTO carries three fields that may further restrict availability: min_stay, max_stay, and days_bef_checkin. Always check these before marking a rate plan as bookable.
RoomTypeAvailabilityDTO — Schema
| Field | Type | Description |
|---|---|---|
date | Date | The calendar date this entry applies to |
price | Double | Price for this night |
total_rooms | int | Rooms available on this date |
isClosed | boolean | Room type is blocked on this date |
minStay | int | Minimum stay from this date (0 = no constraint) |
maxStay | int | Maximum stay from this date (0 = no constraint) |
occupied_rooms | int | Already occupied rooms (informational) |
days | int | Length of stay this entry was calculated for |
