Use the Property API to create or update a property, as well as check and update its status
URL https://connect.booking.com
Connectivity Team connectivity@booking.com
Use the Property API to create or update a property, as well as check and update its status
curl -i -X GET \
'https://supply-xml.booking.com/property-api/properties/{propertyId}/settings'{ "data": { "property_settings": { … }, "pets": { … }, "damage_policy": { … }, "standard_phrases": [ … ], "quiet_hours": { … }, "renovation": { … }, "bed_linen_policy": { … }, "accepted_payment_types": { … }, "french_tax_details": { … }, "cancellation_exceptions": { … }, "age_buckets": [ … ], "children_policies": { … }, "invoice_settings": { … }, "booking_model": { … }, "land_registration_numbers": [ … ] }, "warnings": [ { … } ], "errors": [ { … } ], "meta": { "ruid": "string" } }
Contains multiple various settings related to the property
List of payment methods. Please check for full list of payment codes: https://connect.booking.com/user_guide/site/en-US/codes-bcpt/
An age bucket is a category for children prices that specifies the age range to which the eventual price applies to. You must at least create one, but can create up to three age buckets per property. Each age bucket exists of a minimum and maximum age, where the maximum age is inclusive.
You can indicate whether a property accepts children and specify: price, occupancy and what age children are welcome
Specify if properties have request to book option enabled. Currently available only for: fr, au, us, it, de, gb, es
curl -i -X POST \
'https://supply-xml.booking.com/property-api/properties/{propertyId}/settings' \
-H 'Content-Type: application/json' \
-d '{
"property_settings": {
"require_cvc": true,
"curfew": {
"enabled": true,
"start": "string",
"end": "string"
},
"require_booker_address": true,
"require_booker_phone_number": true,
"age_restriction": {
"enabled": true,
"min": 0,
"max": 0
},
"auto_replenish": true,
"replenish_closed_rooms": true,
"long_stay": {
"enabled": true,
"max_length_of_stay": 0
},
"pricing_type": "STANDARD",
"allow_smoking": true,
"view_cc_details": true
},
"pets": {
"pets_allowed": "PETS_NOT_ALLOWED",
"pets_price_type": "FREE"
},
"damage_policy": {
"amount": 0.1,
"currency": "string",
"policy_type": "NONE",
"damage_programme_terms_agreed": true,
"collection_mode": "CASH",
"collection_when": "ON_ARRIVAL",
"return_mode": "CASH",
"return_when": "ON_CHECKOUT"
},
"standard_phrases": [
{
"name": "GuestIdentification",
"enabled": true
}
],
"quiet_hours": {
"enabled": true,
"start": "string",
"end": "string"
},
"renovation": {
"enabled": true,
"start": "string",
"end": "string"
},
"bed_linen_policy": {
"enabled": true,
"amount": 0.1
},
"accepted_payment_types": {
"codes": [
0
]
},
"french_tax_details": {
"category_id": "string",
"nature_id": "string",
"declare_revenue": true,
"has_vat": true,
"registered_in_rcs": true
},
"cancellation_exceptions": {
"grace_period": {
"enabled": true,
"after_booking": "HOURS_1"
},
"advance_cancellation": {
"enabled": true,
"before_check_in": "WEEKS_4"
}
},
"age_buckets": [
{
"min_age": 17,
"max_age": 17
}
],
"children_policies": {
"allow_children": true,
"min_age": 0,
"policy_rules": [
{
"rule_type": "EXISTING_BED",
"from_age": 0,
"to_age": 0,
"price_type": "FIXED",
"price_mode": "PER_STAY",
"price": 0.1
}
]
},
"booking_model": {
"type": "IB"
},
"invoice_settings": {
"legal_name": "string",
"contact_person": "string",
"address": "string",
"country_code": "string",
"city": "string",
"postal_code": "string",
"state": "st",
"notification_channel": "POSTAL_MAIL",
"brazil_tax_details": {
"tax_payer_number_type": "CNPJ",
"tax_payer_number": "string",
"city_hall_id": "string",
"email": "string"
}
},
"land_registration_numbers": [
"string"
]
}'{ "data": { "property1": { … }, "property2": { … } }, "warnings": [ { … } ], "errors": [ { … } ], "meta": { "ruid": "string" } }
curl -i -X GET \
'https://supply-xml.booking.com/property-api/legal/damage-programme/terms?language_code=string'{ "data": { "raw_full_text": "string" }, "warnings": [ { … } ], "errors": [ { … } ], "meta": { "ruid": "string" } }