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

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

Retrieve room facilities set for a property.

Request

Retrieve the facility details for all the facility instances added to the rooms

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

Responses

OK

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

Manage room-level facilities

Request

Add, modify or delete room-level facilities details for a property

Path
propertyIdinteger(int32)required
roomIdinteger(int64)required
Bodyapplication/jsonrequiredArray [
room_facility_idinteger(int32)required

Room Facility ID

statestringrequired

Is facility Present/Missing?

Enum"MISSING""PRESENT"
room_facility_instancesArray of objects(RoomFacilityInstance)

List of Room Facility Instances

room_facility_metaobject(RoomFacilityMeta)

DEBUG ONLY. Contains Room Facility meta

facilityMetaTypeobject(RoomFacilityMeta)

DEBUG ONLY. Contains Room Facility meta

]
curl -i -X PUT \
  'https://supply-xml.booking.com/facilities-api/properties/{propertyId}/rooms/{roomId}' \
  -H 'Content-Type: application/json' \
  -d '{
    "data": [
      {
        "room_facility_id": 1,
        "state": "PRESENT"
      },
      {
        "room_facility_id": 3,
        "state": "MISSING"
      }
    ]
  }'
Experience it firsthand in the API Explorer!

Responses

OK

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

Manage bathrooms

Operations