Unfortunately, this feature is not supported on mobile devices. For the best experience, please use a computer.

Facilities API (1.0)

Manage facilities at both the property- and room-level.\n Booking.com supports adding or assigning a variety of different facilities at the property- or room-level. Specify the facility ID along with any required parameters to assign a facility.\n\nFacilities are of the following types:

  • Single-instance facilities: You can assign these facilities only once to a property or a room. An example of a single-instance facility is: room service. There are two types of single-instance facilities:
    • Single-instance facilities that can be toggled on or off.
    • Single-instance facilities supporting optional parameters: Allows you to specify more details about the facility
  • Multi-instance facilities: You can assign multiple facilities of this type to a property. When adding multi-instance facilities you must provide additional details to add to a property or a room. Examples of multi-instance facilities are: Restaurant, Swimming pool and Parking.
Download OpenAPI description
facilities-api-specification.json
facilities-api-specification.yaml
Overview
URL https://connect.booking.com
Connectivity Team connectivity@booking.com
Languages
Servers
https://supply-xml.booking.com/facilities-api/

Manage property facilities

Use the GET and the PUT endpoints to:

  • Retrieve property-level facilities details
  • Add, modify or delete property-level facilities details
    • Add single-instance facilities
    • Add multi-instance facilities
Operations

Retrieve property-level facilities

Request

Retrieve facility instance IDs along with the facility details for all the facility instances added to the property.

Path
propertyIdinteger(int32)required
Query
debugInfostring
Default "false"
curl -i -X GET \
  'https://supply-xml.booking.com/facilities-api/properties/{propertyId}?debugInfo=false'
Experience it firsthand in the API Explorer!

Responses

OK

Body*/*
dataArray of objects(PropertyFacility)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)

Add, update or remove property-level facilities

Request

Add or update single or multi-instances facilities using this endpoint. Try any of the three request examples in the specification.

To delete a facility or all instances of a multi-instance facility (for example: all parking facility), you can change the facility state to MISSING.

Path
propertyIdinteger(int32)required
Bodyapplication/jsonrequiredArray [
facility_idinteger(int32)required

Property Facility ID

instancesArray of objects(Instance)

Array of instances

statestringrequired

Is facility Present/Missing?

Enum"MISSING""PRESENT"
property_facility_metaobject(PropertyFacilityMeta)

DEBUG ONLY. Contains Property Facility meta

facilityMetaTypeobject(PropertyFacilityMeta)

DEBUG ONLY. Contains Property Facility meta

]
curl -i -X PUT \
  'https://supply-xml.booking.com/facilities-api/properties/{propertyId}' \
  -H 'Content-Type: application/json' \
  -d '{}'
Experience it firsthand in the API Explorer!

Responses

OK

Body*/*
dataobject(SuccessObject)
warningsArray of objects(ApiError)
errorsArray of objects(ApiError)
metaobject(ResponseMeta)

Meta data endpoint

Retrieve the latest facility definitions.

  • Get the list of all supported facilities
    • To get the details of a property-level facility: Look for a matching name under the facility_name in the response. To add this facility, you must specify the facility_id. Property-level facilities are listed under the property_facility_metas in the meta endpoint response.
    • To get the details of the room-level facility: Look for a matching name under the room_facility_name in the response. To add the facility, you must specify the room_facility_id. Room-level facilities are listed under the room_facility_metas in the meta endpoint response.
  • Details of the facilities such as ID, OTA code and any optional parameters.
Operations

Manage room facilities

Use the GET and the PUT endpoints to:

  • Retrieve room facilities set for a property.
  • Add, modify or delete room facilities.
Operations

Manage bathrooms

Operations