BObooking
Property Details API

Partial update property info

Changed on

Updates the details of a property. All request fields are optional: send only the fields you want to change.

  • You can't update a property in the statuses XML: Ready to check, XML: Ready to open, Closed Post Legal, Closed forever or XML: Hotel is Duplicate.
  • You can update currency_code, primary_language and physical_address only while the property is in the Test Hotel or XML: Being built status.
patch/properties/{propertyId}

Request

Path parameters

propertyIdinteger required

The unique ID of the property to update.

Headers

Accept-Versionstring

The API version to use. Currently supports the value 1.0.

Request body

property_namestring

Specifies the name of the property on Booking.com. Validation: We do not allow CJK Unified Ideographs. Should be shorter than 255 characters. Must have at least 3 letters, one of which must be lower case. Must not have more than 5 numbers. Can't include punctuation, asterisks or symbols. Current Documentation DataMapping: HotelName

property_categoryinteger

The Property Class Type Code for the property. Validation: One of (PCT) Property Class Type Codes (OTA 2014B). Current Documentation DataMapping: HotelCategory/Code

booking_property_categoryinteger

The Booking.com code for property_category. Utilize the meta endpoint for valid values and their OTA mappings.

primary_languagestring

Specifies the language in which the property wants their Booking.com extranet content and communication (emails, notifications, ...) etc. Validation: One of Booking.com Language Code Default: en-gb Current Documentation DataMapping: LanguageCode

languages_spokenstring[]

The languages spoken by staff. Validation: One of Booking.com Language Code DataMapping: HotelInfo->Languages

room_countinteger

The number of sellable units the property offers. DataMapping: GuestRoomInfo->Quantity

floor_countinteger

Total number of floors the building has (excl. underground floors). Validation: Max value of 200 DataMapping: TotalNumberOfFloors->Number

provider_property_idstring

An external id to be associated with the property (e.g. the providers internal id) Validation: Maximum length of 16 characters DataMapping: HotelInfo-ID

currency_codestring

Booking.com defines the currency for each property. In most cases this should not be passed as only one currency is allowed per country. Retrieve a list of all currency codes with /xml/currencies Validation: Must be allowed for property's country Current Documentation Data Mapping: currencyCode

starsstring nullable

The number of stars a property has. Validation: String with values 0 through 5, optionally may include half stars for values 1 or greater (i.e. 0, 1, 1.5, 2, 2.5 ... 4, 4.5, 5) Default: 0 DataMapping: AffiliationInfo->Awards->Award Passing null leaves the current value unchanged.

Response

Property updated.

Changes

  • 414e7c0af4acRevision changes
    • breaking

      added to the request property allOf list

    • breaking

      the request property type changed from object to no type

    • warning

      changed the pattern of the request property from ^0(\.0)?|[1-4](\.[05])?|5(\.0)?$ to ^(0(\.0)?|[1-4](\.[05])?|5(\.0)?)$

    • 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

      the request property became nullable

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the success response with the status

  • d8b4c41776c0Revision changes
    • info

      the request property became optional

    • info

      the request property became optional

    • info

      the request property / became optional

    • info

      the request property / became optional

    • info

      the request property / became optional

    • info

      the request property became optional

    • info

      the request property / became optional

    • info

      the request property / became optional

    • info

      the request property became optional

    • info

      the request property became optional