# Property API

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.

Version: 1.0

## Servers

Test using live endpoint
```
https://supply-xml.booking.com/property-api/
```

## Download OpenAPI description

[Property API](https://developers.booking.com/_bundle/connectivity/docs/openapispecs/property-details-api/property-details-api-specification.yaml)

## Property Details API

Create, update and retrieve property details

### Create property

 - [POST /properties](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-details-api/createpropertyinfo.md)

### Read property

 - [GET /properties/{propertyId}](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-details-api/readpropertyinfo.md)

### Partial update property info

 - [PATCH /properties/{propertyId}](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-details-api/patchpropertyinfo.md)

### Read property

 - [GET /meta](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-details-api/readpropertyinfometa.md)

## Property Settings API

Add, update or retrieve property settings

### Read property settings

 - [GET /properties/{propertyId}/settings](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-settings-api/readpropertysettings.md)

### Create property settings

 - [POST /properties/{propertyId}/settings](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-settings-api/createpropertysettings.md)

### Get Damage Programme Terms

 - [GET /legal/damage-programme/terms](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-settings-api/getdamageprogrammeterms.md)

## Property Status API

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

### Check property status

 - [POST /properties/{propertyId}/status](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-status-api/checkpropertystatus.md)

## Property Description API

Create, update and retrieve property description

### Get existing property description

 - [GET /properties/{propertyId}/description](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-description-api/get.md)

### Create or update property description

 - [PUT /properties/{propertyId}/description](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-description-api/create.md)

### Delete existing property description

 - [DELETE /properties/{propertyId}/description](https://developers.booking.com/connectivity/docs/openapispecs/property-details-api/property-details-api-specification/property-description-api/delete.md)