Use the Property API to create or update a property and its settings; check and update property status; as well as create or update property description.
URL https://connect.booking.com
Connectivity Team connectivity@booking.com
Use the Property API to create or update a property and its settings; check and update property status; as well as create or update property description.
curl -i -X GET \
'https://developers.booking.com/_mock/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/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. For more information, see the full list of payment codes.
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://developers.booking.com/_mock/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/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://developers.booking.com/_mock/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/legal/damage-programme/terms?language_code=string'{ "data": { "raw_full_text": "string" }, "warnings": [ { … } ], "errors": [ { … } ], "meta": { "ruid": "string" } }
Learn how to effectively use the Try it feature in the Property API documentation.
Use the Try it feature to send test request examples to the API endpoints directly from the developer portal and depending on the selected environment either see static, pre-built responses or dynamic responses from a test property.