v1

latestOpenAPI 3.0.32026-07-2632131.4 MB

Calendar

Update calendar for multiple listings

Use this endpoint to set availability and pricing for multiple listings across a range of dates.

IMPORTANT:

It is strongly suggested updating a single unique listing ID in a single HTTP request, despite the fact the API does support receiving different listing IDs.
Max allowed days to be updated - 730 (~2 years)
Strongly suggested to not update the same listing ID in parallel.
To decrease response time, send fewer date periods.

put/availability-pricing/api/calendar/listings

Request body

listingIdstring required

The listing id to update

startDatestring date required

First day affected by changes (format: YYYY-MM-DD)

endDatestring date required

Last date affected by changes (format: YYYY-MM-DD)

status'available' | 'unavailable'

New status, enum: available, unavailable.

pricenumber

New price, in the listing's currency.

isBasePriceboolean

Whether to reset prices for the range to the listing's base price

minNightsinteger

New min nights value

isBaseMinNightsboolean

Whether to reset min nights for the range to the listing's base min nights

notestring

Note to add to those dates.

ctaboolean

Set Closed To Arrival for the date range.

ctdboolean

Set Closed To Departure for the date range.

Example request

[
  {
    "listingId": "5fa02fa358d2db673e17bc2d",
    "startDate": "2023-01-01",
    "endDate": "2023-01-01",
    "status": "available",
    "note": "this is a note"
  }
]

Response

Returns ok if the update successful

string required

Example response

"ok"