Availability & Pricing

Calendar availability, start days, short breaks, and price calculation

📄️ Get unavailable dates for a property

Retrieve all dates that are unavailable (booked or blocked) for a property. Returns an array of date strings that cannot be selected as check-in or stay dates. Use this to grey out dates in a calendar/datepicker widget.

📄️ Get available start days for a property

Retrieve the days of the week on which new bookings can start for a property (e.g., Friday and Saturday only). Returns day-of-week rules that restrict check-in days. Use this to disable non-start days in your datepicker.

📄️ Get short break rules for a property

Retrieve short break configuration for a property including minimum night requirements, allowed start days, and seasonal rules. Use this to determine whether short stays (less than 7 nights) are available and on which dates.

📄️ Get available start dates for next N months

Retrieve specific available check-in dates for a property over the next N months. Unlike startDays (which returns day-of-week rules), this returns actual calendar dates that are open for new bookings. Use this to populate an availability calendar with selectable dates.

📄️ Calculate price for a property stay

Calculate the total price for a property stay including any applicable discounts, cleaning fees, and service fees. Returns the property charge, discount amount, final total in GBP, number of nights, and price per night. A response code of 0 means available; non-zero codes indicate conflicts or restrictions. Call this before creating a booking to show the guest accurate pricing.

📄️ Get available nights from a check-in date

Given a check-in date, returns the valid night durations available for a property (e.g., 3, 4, 7, 14 nights). Takes into account subsequent bookings, minimum stay rules, and short break configuration. Use this to populate a 'number of nights' dropdown after the guest selects a check-in date.