Update Availability Rule
This endpoint updates the availability rules for a specific Airbnb listing, including check-in/check-out days, minimum/maximum nights, booking lead time, and seasonal rules.
Endpoint
POST
Header
app-id
string
Yes
Your application ID. Required for authentication.
Authorization
string
Yes
Your API key. for authorization. Required for authentication.
Content-Type
string
Yes
Must be set to application/json.
Attributes
hotelid alphanumeric (Required)
Specifies the required node hotelid containing the IT provider's hotel ID for which the provider wishes to add mapping information.
channelhotelid alphanumeric (Required)
Specifies the unique hotel ID used in the external distribution channel or PMS (Property Management System).
listingid numeric (Required)
Listing ID of the property allocated by Airbnb.
day_of_week_check_in array of objects (Optional)
Day(s) of the week guests are allowed to check in.
day_of_week enum (Optional)
Value in the range 0-6, representing Sunday to Saturday.
day_of_week_check_out array of objects (Optional)
Day(s) of the week guests are allowed to check out.
day_of_week enum (Optional)
Value in the range 0-6, representing Sunday to Saturday.
day_of_week_min_nights array of objects (Optional)
Minimum number of nights that guests can stay if the reservation starts on a specific day of the week.
day_of_week numeric (Optional)
Value in the range 0-6, representing Sunday to Saturday.
min_nights numeric (Optional)
Minimum number of nights if the trip starts on a specific day of the week. Must fall within the range of -1 to 1125. -1 indicates a deletion operation.
default_min_nights numeric (Optional)
Default minimum night requirement. Must fall within the range of 1 to 1125. Set 0 to reset to default value.
default_max_nights numeric (Optional)
Default maximum night requirement. Must fall within the range of 1 to 1125. Set 0 to reset to default value.
booking_lead_time object (Optional)
Minimum amount of notice required before guests can book. Hosts can choose to either block the calendar or accept Request to Book for reservations on shorter notice.
hours numeric (Optional)
Number of hours required for minimum notice before booking. Valid values are 0-24, 48, 72, and 168.
allow_request_to_book numeric enum (Optional)
Bookings that do not meet the minimum notice requirement can become requests to book instead. Use -1 or 0 to prohibit requests and 1 to allow requests. Default value is -1, requests are not allowed.
Allowed: -1, 0, 1
max_days_notice object (Optional)
Maximum number of days between the booking date and the check-in date. Default value is 30.
days numeric enum (Optional)
Valid values are -1, 0, 30, 60, 90, 120, 150, 180, 210, 240, 270, 300, 330, 365. Pass 0 to make ALL future days unavailable. Pass -1 to reset ALL future days to available.
turnover_days object (Optional)
Amount of days Hosts require for preparation between reservations.
days numeric enum (Optional)
Days to block before and after each reservation. Valid values are 0, 1, and 2.
allow_rtb_above_max_nights boolean (Optional)
Set to true to allow guests to create a Request to Book for reservations with length of stay above the default maximum nights. This setting applies when default_max_nights is 28 or greater. Any seasonal/daily max nights setting overrides this option.
seasonal_min_nights array of objects (Optional)
Minimum number of nights that guests can stay for a specific date range.
start_date string (Optional)
Start date of date range for this rule, as YYYY-MM-DD.
end_date string (Optional)
End date of date range for this rule, as YYYY-MM-DD.
min_nights numeric (Optional)
Minimum number of nights if the trip starts on a day within the range. Must fall within the range of 1 to 1125.
Request
Response
Success Response
Success Response - Body Elements
Status string
Indicates the result of the API call. Will be "Success" if the update succeeds.
Data object
Contains the updated availability rules for the specified listing.
availability_rule object
Root node with all availability rules for the Airbnb listing.
day_of_week_check_in / day_of_week_check_out array of objects
Allowed check-in/check-out days of the week. Each object contains:
day_of_week numeric
Value 0–6, representing Sunday to Saturday.
day_of_week_min_nights array of objects
Minimum nights required based on the day of the week. Each object contains:
day_of_week numeric
Value 0–6, representing Sunday to Saturday.
min_nights numeric
Minimum number of nights if the trip starts on that day.
default_min_nights / default_max_nights numeric
Default minimum and maximum nights for reservations.
booking_lead_time object
Contains the following fields:
hours numeric
Minimum hours of notice required before booking.
allow_request_to_book numeric
– 1 = allowed, -1 or 0 = not allowed.
max_days_notice object
Maximum number of days allowed between the booking date and the check-in date.
days numeric
Allowed values: -1, 0, 30, 60, … 365.
turnover_days object
Preparation days required between bookings.
days numeric
Allowed values: 0, 1, 2.
allow_rtb_above_max_nights boolean
Indicates whether Request to Book above max nights is allowed.
seasonal_min_nights array of objects
Minimum nights for specific date ranges. Each object contains:
start_date string
Start date of the range (YYYY-MM-DD).
end_date string
End date of the range (YYYY-MM-DD).
min_nights numeric
Minimum nights for that date range.
listing_id string
Airbnb listing ID.
Error Response
Error Response - Body Elements
Status string
Indicates the result of the API call.
Will be always "Fail" in case of an error response.
Errors object
The response error, the root element.
Code string
Specific error code that helps identify the type of error.
For example: "400" indicates a bad request.
ShortText string
A short description of the error.
Message string
The message in the response.
Last updated
Was this helpful?