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

FieldTypeDescription
dateDateThe calendar date this entry applies to
priceDoublePrice for this night
total_roomsintRooms available on this date
isClosedbooleanRoom type is blocked on this date
minStayintMinimum stay from this date (0 = no constraint)
maxStayintMaximum stay from this date (0 = no constraint)
occupied_roomsintAlready occupied rooms (informational)
daysintLength of stay this entry was calculated for