Skip to content
Property API
/
/
Troubleshooting

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.

Download OpenAPI description
property-details-api-specification.json
property-details-api-specification.yaml
Overview
URL
https://connect.booking.com
Connectivity Team
connectivity@booking.com
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.

For Delete operations (DELETE)

  • Use static response environment only
  • Understand the operation is irreversible
  • Have backup data when testing using test properties

Troubleshooting

Common issues

401 Unauthorized

  • Check authentication credentials
  • Verify API key is valid and not expired
  • Ensure credentials match the selected environment

400 Bad Request

  • Validate request payload against schema
  • Check required fields are provided
  • Verify data types match specification

404 Not Found

  • Confirm the resource ID exists
  • Check the endpoint URL is correct
  • Verify you have access to the resource