latestOpenAPI 3.0.12026-08-10116777.5 KB

491461b029b5

Property Details API

Create property

post/properties

Headers

Accept-Versionstring

Request body

property_namestring required

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). During creation, either property_category or booking_property_category are required. 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. Validation: During creation, either property_category or booking_property_category are required.

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 required

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

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

target'test' | 'production' required

Specifies whether the request is to create a test property or a real property. Validation: String value of production or test DataMapping: Target

legal_entity_idinteger required

The leid for the property. Current Documentation DataMapping: HotelInfo/OwnershipManagementInfos/OwnershipManagementInfo/CompanyName/Code

Response

default response