GUguesty
Listings

Update a listing

Changed on

Apply a partial update to a listing. Only the fields you send are changed, except arrays, which are replaced wholesale rather than merged. The response echoes back only the fields you sent, together with _id — not the full listing.

put/listings/{id}

Request

  • Base URL
    https://open-api.guesty.com/v1
  • URL
    https://open-api.guesty.com/v1/listings/{id}
  • Auth
    API key in header authorization

Path parameters

idstring required

Listing ID

Request body

accommodatesnumber

Maximum number of guests the listing accommodates.

bathroomsnumber float

Starting March 4th 2025, the bathroom field will be deprecated. Please use the Spaces endpoints to add and manage bathroom details moving forward.

minimumAgenumber

Minimum age required for the primary guest of a reservation at this listing.

defaultCheckInTimestring

Default check-in time for reservations at this listing, in HH:mm format.

defaultCheckOutTimestring

Default check-out time for reservations at this listing, in HH:mm format.

timezonestring

IANA timezone identifier for the listing.

propertyType'Aparthotel' | 'Apartment' | 'Barn' | 'Bed & Breakfast' | 'Boat' | 'Boutique hotel' | 'Bungalow' | 'Cabin' | 'Camper/RV' | 'Casa particular (Cuba)' | 'Castle' | 'Cave' | 'Chalet' | 'Condominium' | 'Cottage' | 'Cycladic house (Greece)' | 'Dammuso' | 'Dome house' | 'Dorm' | 'Earth house' | 'Farm stay' | 'Guest suite' | 'Guesthouse' | 'Heritage hotel (India)' | 'Holiday home' | 'Hostel' | 'Hotel' | 'House' | 'Houseboat' | 'Hut' | 'Igloo' | 'In-law' | 'Inn' | 'Island' | 'Lighthouse' | 'Loft' | 'Minsu' | 'Nature lodge' | 'Other' | 'Parking Space' | 'Pension (South Korea)' | 'Plane' | 'Resort' | 'Rv' | 'Ryokan (Japan)' | 'Serviced apartment' | 'Shepherds hut' | 'Studio' | 'Tent' | 'Timeshare' | 'Tiny house' | 'Tipi' | 'Townhouse' | 'Train' | 'Treehouse' | 'Trullo (Italy)' | 'Vacation home' | 'Villa' | 'Windmill' | 'Yurt'

Describes the kind of property where your guest will stay (e.g., Apartment, House, Villa, Boat, Tent, etc.). Corresponds to the Property type in the UI

roomType'Entire home/apt' | 'Private room' | 'Shared room'

Indicates the level of privacy your guest will have during their stay (e.g., Entire home/apt, Private room, or Shared room). Corresponds to the Listing type in the UI

otaRoomType'Apartment' | 'Bed in dormitory' | 'Bungalow' | 'Chalet' | 'Dormitory room' | 'Double' | 'Family' | 'Holiday home' | 'Mobile home' | 'Quadruple' | 'Single' | 'Studio' | 'Suite' | 'Tent' | 'Triple' | 'Twin' | 'Villa'

A Booking.com-specific field that defines either the property type or room capacity, depending on whether the stay is in a full unit or a single-room setup (e.g., Suite, Double, Villa, Bed in dormitory). Corresponds to the Room type in the UI

childrenToConnectstring[]

Array with children ids that are supposed to be connected

childrenToDisconnectstring[]

Array with children ids that are supposed to be disconnected

numberOfChildrenToCreatenumber

Number of children to create automatically

tagsstring[]

Array of free-text tags associated with the listing.

nicknamestring

Listing nickname.

hostNamestring

Name of the host displayed to guests.

houseManualstring

House manual text shown to guests.

parkingInstructionsstring

Parking instructions shown to guests.

trashCollectedOnstring

Day(s) on which trash is collected at the listing.

wifiNamestring

WiFi network name (SSID) at the listing.

wifiPasswordstring

WiFi network password at the listing.

isTestboolean

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

Example request

{
  "accommodates": 6,
  "minimumAge": 18,
  "defaultCheckInTime": "15:00",
  "defaultCheckOutTime": "10:00",
  "timezone": "Asia/Jerusalem",
  "numberOfChildrenToCreate": 3,
  "address": {
    "full": "Kaplan St 2, Ramat Gan, Israel",
    "lng": 34.8202173,
    "lat": 32.0695525
  },
  "pms": {
    "cleaningStatus": {
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  }
}

Response

Retrieve the updated listing, selection of fields that were sent in body.

_idstring

Unique Guesty listing ID.

accountIdstring

Unique Guesty account ID.

createdAtstring
isVirtualboolean
nicknamestring
tagsstring[]
isListedboolean
titlestring
propertyTypestring
roomTypestring
bedTypestring
accommodatesnumber
bedroomsnumber
areaSquareFeetnumber
timezonestring
defaultCheckInTimestring
defaultCheckOutTimestring
amenitiesstring[]

Array of amenities. Use the amenities endpoints to review and manage this list.

amenitiesNotIncludedstring[]

Array of amenities not included. Use the amenities endpoints to review and manage this list.

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",
      "id": "naama@user.guesty.com",
      "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",
    "large": "https://res.cloudinary.com/guesty/image/upload/c_fit,w_756/v1659982852/staging6/5213a2d206112710005d96ff/gglflnes8vodgkmtm08c.jpg",
    "caption": "Living room",
    "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",
      "large": "https://res.cloudinary.com/guesty/image/upload/c_fit,w_756/v1659982852/staging6/5213a2d206112710005d96ff/gglflnes8vodgkmtm08c.jpg",
      "caption": "Living room",
      "height": 756,
      "original": "https://res.cloudinary.com/guesty/image/upload/v1659982852/staging6/5213a2d206112710005d96ff/gglflnes8vodgkmtm08c.jpg",
      "size": 39516,
      "width": 756
    }
  ],
  "terms": {
    "minNights": 1,
    "maxNights": 30,
    "cancellation": "STANDARD"
  },
  "prices": {
    "guestsIncludedInRegularFee": 6,
    "extraPersonFee": 55.5,
    "monthlyPriceFactor": 0.9,
    "weeklyPriceFactor": 0.9,
    "weekendBasePrice": 150,
    "securityDepositFee": 100,
    "cleaningFee": 50
  },
  "pms": {
    "cleaningStatus": {
      "updatedAt": "2019-08-24T14:15:22Z"
    }
  }
}

Changes

  • 3122b8618183Revision changes
    • breaking

      added subschema #1 to the request property allOf list

    • breaking

      added subschema #1 to the request property allOf list

    • breaking

      added subschema #1 to the request property allOf list

    • breaking

      added the pattern ^([01]\d|2[0-3]):([0-5]\d)$ to the request property

    • breaking

      added the pattern ^([01]\d|2[0-3]):([0-5]\d)$ to the request property

    • breaking

      the request property format changed from no format to int32

    • breaking

      the request property type changed from object to no type

    • breaking

      the request property format changed from no format to float

    • breaking

      the request property type changed from object to no type

    • breaking

      the request property format changed from no format to int32

    • breaking

      the request property format changed from no format to int32

    • breaking

      the request property type changed from object to no type

    • breaking

      the // response's property type changed from integer to string for status

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • warning

      removed the request property /

    • info

      api operation id propertiesListingUpdate was added

    • info

      added the optional property to the response with the status

    • info

      the / response's property pattern ^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$ was added for the status