Property API (1.0)

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.

Languages
Servers
Test static response
https://developers.booking.com/_mock/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/
Test using live endpoint
https://supply-xml.booking.com/property-api/

Property Details API

Create, update and retrieve property details

Operations

Property Settings API

Add, update or retrieve property settings

Operations

Property Status API

Check if a property is ready to open; open or close a property

Operations

Property Description API

Create, update and retrieve property description

Operations

About Try it

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.

Environments

The Environments tab allows you to create variables specific to the environment. For example, you can add a variable to hold the value of the property-id placeholder. The portal inserts the respective value depending on the environment at the time of sending the request.

Variables

Most of the endpoints (especially POST/PUT/DELETE) require you to add a path or query parameter before sending the request. The Open API specification marks these parameters with placeholder tags. For example, {{property_id}}. You can use the Environments tab to manage the values for these placeholders as variables.

Path parameters

  • Required: Must be provided to make the request
  • Type validation: Ensures correct data types (integer, string, etc.)
  • Example: propertyId in /property-api/properties/{propertyId}