Booking Settings

Define a property's booking window and default availability.

Overview

You can use a combination of the Update listings availability settings and Update a listing endpoints to control your property's default availability and booking lead time.


Default Availability

Available Endpoints



Key Parameters

Default availability is configured through a combination of the following parameters.


Body ParametersTypeDescriptionRequired
calendarRulesobjectContains the availability settings.yes
    defaultAvailabilitystringMust be: available or unavailable.yes
rentalPeriods[object]An array of date objects. It defines the dates the property is available for rent when it is unavailable by default.
    fromstringThe start date for the rental period. E.g. "2024-11-20".
    tostringThe end date for the rental period. E.g. "2025-01-08".
bookingWindowobjectDefines how far ahead a guest can book.
    defaultSettingsobjectyes
      daysnumberThe number of days ahead a guest can book. e.g., 180

When the property is available for bookings all year around, it should be available by default and have a booking window. If the property is seasonal, it should be unavailable by default with set rentalPeriods.


Booking Lead Time

These parameters control the lead time for bookings:


Key Parameters


Body ParametersTypeDescriptionRequired
calendarRulesobjectContains the availability settings.yes
preparationTimeobjectAllocated days to preparations before and between stays.
     defaultSettingsobject
      daysnumberone (1) or two (2)nights.
      whenstringBEFORE, AFTER, or BEFORE_AND_AFTER a stay.
advanceNoticeobjectSpecify the number of days required in advance to book a stay.
    defaultSettingsobject
    hoursnumberone, two, three, or seven days in hours. E.g., 72
  dynamicCheckinobject[Pilot] Adjust the time between reservations to optimize occupancy.
    defaultSettingsobject
      daysnumberThe number of days after check-out. E.g., 1.

Default Check-in & Check-out Times

Use the listings endpoint to set your property's default check-in and check-out times.


Available Endpoints


MethodURL
PUT/listings/{id}

Key Parameters


Body ParametersTypeDescriptionRequired
defaultCheckOutTimestringThe property's default check-out time (HH:MM). E.g., "10:00".
defaultCheckInTimestringThe property's default check-in time (HH:MM). E.g., "15:00".
defaultCheckInEndTimestringFor Airbnb listings, you can implement a check-in window by setting an end time (HH:MM) for the check-in window. E.g., "12:00".

Length of Stay Limits

Specify the listing's default minimum and maximum stay limits.


Available Endpoints


MethodURL
PUT/listings/{id}

Key Parameters


Body ParameterTypeDescriptionRequired
termsobjectyes
  minNightsnumberThe default minimum number of nights to qualify for a stay. E.g., 4yes
  maxNightsnumberThe maximum number of nights a stay can be booked for. E.g., 28yes