v1

latestOpenAPI 3.0.32026-07-2632131.4 MB

Listings

Update listings availability settings

put/listings/{id}/availability-settings

Path parameters

idstring required

Listing ID

Request body

Example request

{
  "calendarRules": {
    "defaultAvailability": "AVAILABLE",
    "advanceNotice": {
      "defaultSettings": {
        "hours": 0,
        "allowRequestToBook": false
      }
    },
    "bookingWindow": {
      "defaultSettings": {
        "days": 180
      }
    },
    "dynamicCheckin": {
      "defaultSettings": {
        "days": 10
      }
    },
    "weekendMinNights": 2,
    "rentalPeriods": [],
    "seasonalMinNights": [
      {
        "from": "2020-12-01",
        "to": "2021-12-01",
        "minNights": 1
      },
      {
        "from": "2020-02-29",
        "to": "2020-11-30",
        "minNights": 4
      }
    ]
  }
}

Response

The updated object.

_idstring

String (ObjectId)

accountIdstring

String (ObjectId)

createdAtstring

isVirtualboolean

nicknamestring

tagsstring[]

isListedboolean

titlestring

propertyTypestring

roomTypestring

bedTypestring

accommodatesnumber

bedroomsnumber

areaSquareFeetnumber

timezonestring

defaultCheckInTimestring

defaultCheckOutTimestring

amenitiesstring[]

amenitiesNotIncludedstring[]

netIncomeFormulastring

commissionFormulastring

commissionTaxPrecentagestring

activeboolean

customFieldsobject

calendarRulesobject

publicDescriptionobject

privateDescriptionobject

markupsobject

isTestboolean

Marks the listing as a test property. Test property titles must include the 'Test_' prefix. Only SINGLE-type listings can be selected.

Example response

{
  "_id": "59ac245d27cb310f0017afe3",
  "accountId": "59ac245d27cb310f0017afe3",
  "createdAt": "2017-09-03T15:48:45.070Z",
  "integrations": [
    {
      "_id": "5958c7e5884e961000817799",
      "airbnb2": {
        "ignored": {
          "reservations": [],
          "listings": []
        },
        "emailsFromSupport": []
      },
      "nickname": "naama",
      "userId": "563e0b6a08a2710e00057b85",
      "accountId": "563e0b6a08a2710e00057b82"
    }
  ],
  "address": {
    "full": "Kaplan St 2, Ramat Gan, Israel",
    "lng": 34.8202173,
    "lat": 32.0695525
  },
  "publishedAddress": {
    "full": "Kaplan St 2, Ramat Gan, Israel",
    "lng": 34.8202173,
    "lat": 32.0695525
  },
  "cleaningStatus": {
    "updatedAt": "2019-08-24T14:15:22Z"
  },
  "picture": {
    "thumbnail": "https://res.cloudinary.com/guesty/image/upload/c_fit,h_200/v1659982852/staging6/5213a2d206112710005d96ff/gglflnes8vodgkmtm08c.jpg",
    "height": 756,
    "original": "https://res.cloudinary.com/guesty/image/upload/v1659982852/staging6/5213a2d206112710005d96ff/gglflnes8vodgkmtm08c.jpg",
    "size": 39516,
    "width": 756
  },
  "pictures": [
    {
      "thumbnail": "https://res.cloudinary.com/guesty/image/upload/c_fit,h_200/v1659982852/staging6/5213a2d206112710005d96ff/gglflnes8vodgkmtm08c.jpg",
      "height": 756,
      "original": "https://res.cloudinary.com/guesty/image/upload/v1659982852/staging6/5213a2d206112710005d96ff/gglflnes8vodgkmtm08c.jpg",
      "size": 39516,
      "width": 756
    }
  ],
  "pms": {
    "cleaningStatus": {
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  }
}