Update a listing

put

https://open-api.guesty.com/v1/listings/{id}

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.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

string

required

Listing ID

Body Params

Listing new values

accommodates

number

Maximum number of guests the listing accommodates.

bathrooms

float

deprecated

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

minimumAge

number

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

defaultCheckInTime

string

^([01]\d|2[0-3]):([0-5]\d)$

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

defaultCheckOutTime

string

^([01]\d|2[0-3]):([0-5]\d)$

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

timezone

string

IANA timezone identifier for the listing.

propertyType

string

enum

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

string

enum

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

Allowed:

otaRoomType

string

enum

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

childrenToConnect

array of strings

Array with children ids that are supposed to be connected

childrenToConnect

childrenToDisconnect

array of strings

Array with children ids that are supposed to be disconnected

childrenToDisconnect

numberOfChildrenToCreate

number

Number of children to create automatically

address

object

Listing address.

pms

object

Property management system (PMS) configuration for the listing.

tags

nickname

string

Listing nickname.

publicDescription

object

Public-facing description sections for the listing.

hostName

string

Name of the host displayed to guests.

houseManual

string

House manual text shown to guests.

parkingInstructions

string

Parking instructions shown to guests.

trashCollectedOn

string

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

wifiName

string

WiFi network name (SSID) at the listing.

wifiPassword

string

WiFi network password at the listing.

cleaning

object

Cleaning configuration for the listing.

isTest

boolean

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

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

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