Skip to content
Property API
/
/
Create property

Create property

Request

Headers
Accept-Versionstring
Bodyapplication/jsonrequired
translationsArray of objects(Translation)

Non-English translations of the physical address Current Documentation DataMapping: Addresses

positionobject(Position)required

Current Documentation Data Mapping: Position

check_inobject(TimeRange)required

Current Documentation Data Mapping: PolicyInfo/CheckInTime/CheckOutTime

check_outobject(TimeRange)

Current Documentation Data Mapping: PolicyInfo/CheckInTime/CheckOutTime

property_namestring, [ 3 .. 255 ] charactersrequired

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, (int32)

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, (int32)

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_spokenArray of strings

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

room_countinteger, (int32), >= 0required

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

floor_countinteger, (int32), [ 0 .. 200 ]

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

provider_property_idstring, [ 0 .. 16 ] characters

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, [ 0 .. 3 ] characters

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^0(\.0)?|[1-4](\.[05])?|5(\.0)?$

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

targetstringrequired

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

Enum:"test""production"
physical_addressobject(Address)required
legal_entity_idinteger, (int64)required

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

curl -i -X POST \
  https://developers.booking.com/_mock/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/properties \
  -H 'Accept-Version: string' \
  -H 'Content-Type: application/json' \
  -d '{
    "translations": [
      {
        "city_name": "string",
        "address_line": "string",
        "language_code": "string",
        "property_name": "string"
      }
    ],
    "position": {
      "latitude": -90,
      "longitude": -180
    },
    "check_in": {
      "from": "string",
      "until": "string"
    },
    "check_out": {
      "from": "string",
      "until": "string"
    },
    "property_name": "string",
    "property_category": 0,
    "booking_property_category": 0,
    "primary_language": "string",
    "languages_spoken": [
      "string"
    ],
    "room_count": 0,
    "floor_count": 0,
    "provider_property_id": "string",
    "currency_code": "str",
    "stars": "string",
    "target": "test",
    "physical_address": {
      "city_name": "string",
      "country_code": "string",
      "postal_code": "string",
      "address_line": "string",
      "display_address": true
    },
    "legal_entity_id": 0
  }'

Responses

default response

Bodyapplication/json
dataobject(PropertyId)
warningsArray of objects(ApiErrorOTA)
errorsArray of objects(ApiErrorOTA)
metaobject(ResponseMeta)
Response
{
  "data": {
    "property_id": 0
  },
  "warnings": [
    { … }
  ],
  "errors": [
    { … }
  ],
  "meta": {
    "ruid": "string"
  }
}