Lists the API endpoints accessible under each connection type. Use this page when building your integration to verify which endpoints a connection grants access to.
Connection type is one of several requirements
This page shows which endpoints a connection type makes available. For a successful API call, the endpoint must also be enabled for the machine account in the Provider Portal, the property must be linked to the machine account, and any required certifications must be in place. See Managing endpoint access.
This topic covers the following connection types:
- Available under all connection types
- Reservations
- Rates and Availability
- Promotions
- Guest reviews
- Reporting
- Content
- Photos
- Messaging
- Performance data and insights
- Payments by Booking.com onboarding
Connection status
Note that you must have a connection for the relevant connection type before using an endpoint. Depending on the endpoint, access may be available while the connection is Pending, or only after the connection is Approved. See the sections below for the required connection status for each endpoint. The connection-status values in the following tables mean:
Pending: The endpoint is available after the property has sent a connection request, and before you have accepted it.Approved: The endpoint is available only after you have accepted the connection request and the connection is active.
The following endpoints use the DEFAULT READ permission and are available under all connection types, including Payments.
| Endpoint | Connection status | Restrictions |
|---|---|---|
OTA_HotelSearch — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelSearch | Pending or Approved | |
opportunity-api — GET https://supply-xml.booking.com/opportunity-api/opportunities | Approved | |
market-insights-api — GET https://supply-xml.booking.com/market-insights-api/properties/{property_id}/area_demand_data | Pending or Approved | Requires provider certification |
property-scores-api — GET https://supply-xml.booking.com/property-scores/summary | Approved |
| Endpoint | Connection status | Restrictions |
|---|---|---|
reservationssummary — POST https://secure-supply-xml.booking.com/hotels/xml/reservationssummary | Pending or Approved | PII compliant |
reservations — POST https://secure-supply-xml.booking.com/hotels/xml/reservations | Approved | PCI and PII compliant |
OTA_HotelResNotif — POST https://secure-supply-xml.booking.com/hotels/ota/OTA_HotelResNotif | Approved | Requires PCI and PII compliance |
OTA_HotelResModifyNotif — POST https://secure-supply-xml.booking.com/hotels/ota/OTA_HotelResModifyNotif | Approved | Requires PCI and PII compliance |
Rates — POST https://supply-xml.booking.com/hotels/xml/rates | Pending or Approved | |
Roomrates — POST https://supply-xml.booking.com/hotels/xml/roomrates | Pending or Approved | |
GetCommissionOverride — POST https://supply-xml.booking.com/hotels/xml/getcommissionoverride | Pending or Approved | |
GetPromotions — POST https://supply-xml.booking.com/hotels/xml/getpromotions | Pending or Approved | |
RoomRateAvailability — POST https://supply-xml.booking.com/hotels/xml/roomrateavailability | Pending or Approved | |
Availability — POST https://supply-xml.booking.com/hotels/xml/availability | Approved |
The following endpoints are temporarily accessible under the Reservations connection type and will be removed in a future update:
| Endpoint | Connection status |
|---|---|
review-api (read) — GET https://supply-xml.booking.com/review-api/properties/{id}/reviews | Pending or Approved |
review-api (write) — POST https://supply-xml.booking.com/review-api/properties/{id}/reviews/{review_id} | Approved |
Reporting — POST https://supply-xml.booking.com/hotels/xml/reporting | Approved |
| Endpoint | Connection status |
|---|---|
Rates — POST https://supply-xml.booking.com/hotels/xml/rates | Pending or Approved |
Roomrates — POST https://supply-xml.booking.com/hotels/xml/roomrates | Pending or Approved |
GetCommissionOverride — POST https://supply-xml.booking.com/hotels/xml/getcommissionoverride | Pending or Approved |
OTA_HotelProductNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelProductNotif | Approved |
OTA_HotelRatePlanNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelRatePlanNotif | Approved |
GetPromotions — POST https://supply-xml.booking.com/hotels/xml/getpromotions | Pending or Approved |
GetPromotionChannels — POST https://supply-xml.booking.com/hotels/xml/getpromotionchannels · Deprecated | Pending or Approved |
Promotions — POST https://supply-xml.booking.com/hotels/xml/promotions | Approved |
RoomRateAvailability — POST https://supply-xml.booking.com/hotels/xml/roomrateavailability | Pending or Approved |
Availability — POST https://supply-xml.booking.com/hotels/xml/availability | Approved |
DerivedPrices — POST https://supply-xml.booking.com/hotels/xml/derivedprices | Approved |
LOSPricing — POST https://supply-xml.booking.com/hotels/csv/los_pricing | Approved |
OTA_HotelAvailNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelAvailNotif | Approved |
OTA_HotelRateAmountNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelRateAmountNotif | Approved |
OTA_HotelBookingRuleNotif - POST /hotels/ota/OTA_HotelBookingRuleNotif | Approved |
| Endpoint | Connection status |
|---|---|
Rates — POST https://supply-xml.booking.com/hotels/xml/rates | Pending or Approved |
Roomrates — POST https://supply-xml.booking.com/hotels/xml/roomrates | Pending or Approved |
GetCommissionOverride — POST https://supply-xml.booking.com/hotels/xml/getcommissionoverride | Pending or Approved |
GetPromotions — POST https://supply-xml.booking.com/hotels/xml/getpromotions | Pending or Approved |
GetPromotionChannels — POST https://supply-xml.booking.com/hotels/xml/getpromotionchannels · Deprecated | Pending or Approved |
Promotions — POST https://supply-xml.booking.com/hotels/xml/promotions | Approved |
RoomRateAvailability — POST https://supply-xml.booking.com/hotels/xml/roomrateavailability | Pending or Approved |
Availability — POST https://supply-xml.booking.com/hotels/xml/availability | Approved |
| Endpoint | Connection status |
|---|---|
review-api (read) — GET https://supply-xml.booking.com/review-api/properties/{id}/reviews | Pending or Approved |
review-api (write) — POST https://supply-xml.booking.com/review-api/properties/{id}/reviews/{review_id} | Approved |
| Endpoint | Connection status | Restrictions |
|---|---|---|
Reporting — POST https://supply-xml.booking.com/hotels/xml/reporting | Approved | Requires PCI compliance |
| Endpoint | Connection status | Restrictions |
|---|---|---|
Rooms — GET, POST, PATCH, and DELETE https://supply-xml.booking.com/rooms-api/properties/{propertyId}/units | GET: Pending or Approved; POST/PATCH/DELETE: Approved | |
OTA_HotelInvNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelInvNotif · Deprecated | Approved | |
OTA_HotelProductNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelProductNotif | Approved | |
OTA_HotelRatePlanNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelRatePlanNotif | Approved | |
OTA_HotelDescriptiveInfo — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveInfo · Deprecated | Pending or Approved | Requires PII compliance |
OTA_HotelDescriptiveContentNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveContentNotif · Deprecated | Approved | |
licenses-api — GET, PUT, POST https://supply-xml.booking.com/licenses | Reads: Pending or Approved; writes: Approved | |
house-rules-api — GET, POST https://supply-xml.booking.com/house-rules/properties/{property_id} | Approved | |
checkin-methods-api Deprecated — GET, POST and DELETE https://supply-xml.booking.com/checkin-methods-api | GET: Pending or Approved; POST/DELETE: Approved | |
property-profile-api — GET, POST, DELETE https://supply-xml.booking.com/property-profile | GET: Pending or Approved; POST/DELETE: Approved | GET uses DEFAULT READ and is available under all connection types; POST/DELETE use PROPERTY INFO WRITE and require Content |
property-api — GET, POST, PATCH https://supply-xml.booking.com/property-api/properties | GET: Pending or Approved; POST/PATCH: Approved | |
contacts-api — GET, PUT https://supply-xml.booking.com/contacts-api/properties/{propertyID}/contacts | GET: Pending or Approved; PUT: Approved | |
OTA_HotelSummaryNotif — POST https://supply-xml.booking.com/hotels/ota/OTA_HotelSummaryNotif · Deprecated | Approved | |
photo-api — GET, POST, PUT, DELETE https://supply-xml.booking.com/photo-api | GET: Pending or Approved; POST/PUT/DELETE: Approved | Temporarily under Content; will move to Photos |
| Endpoint | Connection status |
|---|---|
photo-api — GET, POST, PUT, DELETE https://supply-xml.booking.com/photo-api | GET: Pending or Approved; POST/PUT/DELETE: Approved |
| Endpoint | Connection status | Restrictions |
|---|---|---|
Messaging API — GET https://supply-xml.booking.com/messaging/properties/{property_id}/conversations | Approved |
No endpoints are currently documented for this connection type beyond those listed under Available under all connection types.
| Endpoint | Connection status |
|---|---|
Payments Eligibility — POST https://payments-api.booking.com/connectivity-payments/pbb/eligibility | Approved |
Payments Configuration — POST https://payments-api.booking.com/connectivity-payments/pbb/configurations | Approved |
Payments Configuration Status — POST https://payments-api.booking.com/connectivity-payments/pbb/configurations/status | Approved |
- Connections API overview — Background on connection types and connection states
- Manage connections — Accept, reject, and deactivate connections