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:
- Authentication and static reference endpoints
- Available under all connection types
- Reservations
- Rates and Availability
- Promotions
- Guest reviews
- Reporting
- Content
- Photos
- Messaging (Guest messages)
- 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.
None of the endpoints in this section require a connection. The token-based authentication endpoint accepts your machine account credentials and returns an access token scoped to the properties linked to that machine account. The remaining endpoints return static catalog data with no property context, and a valid access token is sufficient to call them.
| Endpoint | URL |
|---|---|
| Token-based authentication | https://connectivity-authentication.booking.com/token-based-authentication/exchange |
| City_Tax_Category | https://supply-xml.booking.com/hotels/xml/citytaxcategory |
| Code_Groups | https://supply-xml.booking.com/hotels/xml/codegroups |
| Countries | https://supply-xml.booking.com/hotels/xml/countries |
| Country_Currencies | https://supply-xml.booking.com/hotels/xml/countrycurrencies |
| Payments_Configuration | https://supply-xml.booking.com/hotels/xml/creditcards |
| Get_Promotion_Types | https://supply-xml.booking.com/hotels/xml/promotiontypes |
| Misconduct-Category | https://supply-xml.booking.com/hotels/xml/misconductcategory |
| Room_Name | https://supply-xml.booking.com/hotels/xml/roomname |
| Value_Adds_Catalog | https://supply-xml.booking.com/valueadds/properties/catalog |
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 |
Certification requirement
Endpoints marked with a certification requirement in the Restrictions column are only accessible after Booking.com has verified that the provider meets the relevant data-handling standard. Having the correct connection type alone is not sufficient. To apply for PCI or PII certification, see Introduction on PCI and PII compliance.
| Endpoint | Connection status | Restrictions |
|---|---|---|
reservationssummary — POST https://secure-supply-xml.booking.com/hotels/xml/reservationssummary | Pending or Approved | Requires PII certification |
reservations — POST https://secure-supply-xml.booking.com/hotels/xml/reservations | Approved | Requires PCI and PII certification |
OTA_HotelResNotif — POST https://secure-supply-xml.booking.com/hotels/ota/OTA_HotelResNotif | Approved | Requires PCI and PII certification |
OTA_HotelResModifyNotif — POST https://secure-supply-xml.booking.com/hotels/ota/OTA_HotelResModifyNotif | Approved | Requires PCI and PII certification |
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 https://supply-xml.booking.com/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 certification |
| Endpoint | Connection status | Restrictions |
|---|---|---|
Rooms — GET, POST https://supply-xml.booking.com/rooms-api/properties/{propertyId}/units | GET: Pending or Approved; POST: Approved | |
Rooms — PATCH, DELETE https://supply-xml.booking.com/rooms-api/properties/{propertyId}/units/{unitId} | 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 certification |
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