Search Home Contracting API New! Content API Photo API New! Rates & Availability API Reservations API Promotions API Messaging API Guest Review API New! Opportunities API New! Reporting API Property scores API New! Licences API New! Services API reference

Home

About the Connectivity APIs Authentication Curl Requests Glossary

Getting started

Tutorial: Create a test property Prologue – Hello, World! Step 1 – Create property Step 2 – Retrieve property details Step 3 – Create room type Step 4 – Create rate plan Step 5 – Create product Step 6 – Push availability Step 7 – Checks Epilogue – Whats next?

Understanding the Contracting API

Contract management

Managing contracts Use cases and best pactrices

Content API overview Property statuses Licence requirements per region Supporting calls

Managing rooms & rates

Section overview Create room Create multi-bedroom setup Modify room amenities Modify room photos Deactivate room Activate room Creating and updating rate plans Rename rate Deactivate rate Activate rate Create product Modify product Delete product

Managing properties

Section overview Create property Create independent property Modify property name Modify property contact details Modify property photos Modify property facilities Modify property policies Setting up children policies and child rates (pricing) Implementing or disabling CVC collection Preparing a property to be open bookable Retrieve property details Retrieve property attributes Retrieve regional licence requirements Retrieve house rules Set house rules Specify property mealplans Property Profile API Key Collection API Key Collection API: Generic Calls Key Collection API: Per-Property Calls Key Collection API: Methods Descriptions Key Collection API: External References Key Collection API: Manage photos

API endpoints

/ota/OTA_HotelDescriptiveContentNotif /ota/OTA_HotelDescriptiveInfo /ota/OTA_HotelInvNotif /ota/OTA_HotelProductNotif /ota/OTA_HotelRatePlanNotif /ota/OTA_HotelSearch /ota/OTA_HotelSummaryNotif

Understanding the Photo API

Photo API management

Managing photos Managing panoramic (360) photos Managing photo galleries Self-assessment tutorial

Understanding the Licences API

Licences API management

Managing licences

Rates & Availability API overview Pricing models

B.XML endpoints

Create/update inventory, rates, restrictions Create/update rates (Derived pricing) Self-assessment tutorial (Derived pricing)

OTA endpoints

Create/update inventory, restrictions Create/update rates

CSV endpoints

Create/update rates (LOS pricing)

Reservations API overview Reservations API best practices

B.XML endpoints

Retrieve new/modified/cancelled reservations Retrieve reservations summary

OTA endpoints

Retrieve/confirm new reservations Retrieve confirm modified/cancelled reservations

Promotions API overview Create/update a promotion Retrieve promotion details Retrieve promotion channels Self-assessment tutorial FAQ

Understanding the Messaging API

Messaging API management

Managing messages Managing message queries Managing conversations

Guest Review API overview

Sample requests

Retrieve reviews Reply to a review Retrieve property scores Self-assessment tutorial Access reviews iframe

Using the Opportunities API

Opportunities API management

Retrieving opportunities Implementing or dismissing opportunities

Overview Misconduct Categories

Managing property scores

Overview Code Groups (Added 2017-08-08) Country Codes/Names Country Codes/Currency Codes Credit Card Names/OTA codes Currency Codes/Names Get Legal Entities Get Property Commission Rate IDs/Names Room Names City Tax Categories Room IDs/Names Room Rate Availability Room/Rate IDs/Names/Policies

Overview

Booking.com codes

BCBI (Breakfast Item) BCBT (Breakfast Type) BCCP (Cancellation Policies) BCIO (Check-In/Out Times) BCJT (Job Titles) BCL (Language) BCPT (Payment Type) BCRT (Room Type)

OTA codes

ACC (Attraction Category Code) CHG (Charge Type) CUI (Main Cuisine Code) ERR (Error Codes) FTT (Fee Tax Type) HAC (Hotel Amenity) ITT (Image Tag Type) MPT (Meal Plan Type) OTC (Option Type) PCT (Property Class Type) PTT (Phone Technology Type) RMA (Room Amenity Type) TRP (Transportation Code) UIT (Unique ID Type)

OTA objects

AcceptedPayment AcceptedPayments AdditionalDetail AdditionalDetails Address Addresses AffiliationInfo Ambiance Ambiances Amenities Amenity AreaInfo Attraction Attractions Attribute Award Awards Base BasicPropertyInfo BookingRule BookingRules CancellationGracePeriod CancelPenalties CancelPenalty CancelPolicy CategoryCodes Charge Comment Comments Commission CommissionPayableAmount CompanyName Condition Conditions ContactInfo ContactInfos Criteria Criterion CuisineCode CuisineCodes Customer Departure DepositPayments Description Descriptions DescriptiveText DetailDescription DietaryOption DietaryOptions Email Emails Error Errors FacilityInfo Feature Features Fee FeePolicies FeePolicy Fees Floor Floors Guarantee GuaranteeAccepted GuaranteePayment GuaranteePaymentPolicy GuaranteesAccepted GuestCount GuestCounts GuestInformation GuestRoom GuestRoomInfo GuestRooms HotelCategory HotelCrossRef HotelCrossRefs HotelDescriptiveContent HotelDescriptiveContents HotelDescriptiveInfo HotelDescriptiveInfos HotelInfo

Fields XML Related endpoints

HotelProduct HotelProducts HotelRef HotelResModifies HotelResModify HotelReservation HotelReservationID HotelReservationIDs HotelReservations HotelSummaryMessage HotelSummaryMessages HotelierMessage ImageFormat ImageItem ImageItems ImageTag ImageTags InternetFeePolicy InventoryCrossRef InventoryCrossRefs InvoiceDetails Item Items JourneyTime Junction Language Languages Leg LicenseInfo LicenseInfos Line MealPlan Motorway MultimediaDescription MultimediaDescriptions Name Names NoShowPolicy OTA_HotelDescriptiveContentNotifRQ OTA_HotelDescriptiveContentNotifRS OTA_HotelDescriptiveInfoRQ OTA_HotelDescriptiveInfoRS OTA_HotelInvNotifRQ OTA_HotelInvNotifRS OTA_HotelProductNotifRQ OTA_HotelProductNotifRS OTA_HotelRatePlanNotifRQ OTA_HotelRatePlanNotifRS OTA_HotelResModifyNotifRQ OTA_HotelResModifyNotifRS OTA_HotelResNotifRQ OTA_HotelResNotifRS OTA_HotelSearchRQ OTA_HotelSearchRS OTA_HotelSummaryNotifRQ OTA_HotelSummaryNotifRS Occupancy OperationSchedule OperationSchedules OperationTime OperationTimes Option Options OwnershipManagementInfo OwnershipManagementInfos ParkingFeePolicy PaymentCard PersonName PetsPolicies PetsPolicy Phone Phones Policies Policy PolicyInfo Position PrepaymentPolicy PreventLikelyToBeCancelledBookings Price PricingType Profile ProfileInfo Profiles Properties Property PropertyManagedBy PropertyTaxInfo Rate RatePlan RateDescription RatePlanCrossRef RatePlans Rates RelativePosition RelativePositions ResGlobalInfo ReservationTime ResGuest ResGuestRPH ResGuestRPHs ResGuests Restaurant Restaurants Room RoomDescription RoomLocation RoomRate RoomRates RoomStay RoomStays RoomType RoomTypes Route SellableProduct SellableProducts SellMealsThroughBooking Service ServiceDetails ServiceExtraIdentificationInfo ServiceRPH ServiceRPHs Services SpecialRequest SpecialRequests StandardPhrase StandardPhrases Start SubRoom SubRooms TPA_Extensions TaxPolicies TaxPolicy Telephone Text TextItem TextItems TimeSpan Total TotalNumberOfFloors TransportType Transportation Transportations Type TypeOfResidence Types UniqueID ValueAddInclusions Warning Warnings

HotelInfo¶

Fields¶

Field	Description	Type	Min/max	Notes
_{HotelDescriptiveContent/} `HotelInfo`	Information about the types of rooms and services a property offers.	object	1..1	-
_HotelInfo/ CategoryCodes	General property details, such as number of rooms and property type.	object	0..1	-
_HotelInfo/ Languages	Languages spoken at the property.	array of Language	0..1	-
_HotelInfo/ Position	Geographical coordinates of property.	object	0..1	-
_HotelInfo/ Services	Services offered at the property.	array of Service	0..1	-
_HotelInfo/ OwnershipManagementInfos	Information about the property's relationship to Booking.com.	array of OwnershipManagementInfo	1..1	-
_HotelInfo/ RelativePositions	Travel routes to and from the property.	array of RelativePosition	0..1	-
_HotelInfo/ TPA_Extensions	Container for AcceptedPayments, HotelierMessage, and InvoiceDetails.	object	0..1	-

XML¶

<HotelInfo>
   <CategoryCodes>
     ...
   </CategoryCodes>
   <Languages>
     ...
   </Languages>
   <Position ... />
   <Services>
     ...
   </Services>
   <OwnershipManagementInfos>
     ...
   </OwnershipManagementInfos>
   <RelativePositions>
     ...
   </RelativePositions>
   <TPA_Extensions>
     ...
   </TPA_Extensions>
</HotelInfo>

Related endpoints¶

/ota/OTA_HotelDescriptiveContentNotif

Is this page helpful? Yes | No

Thanks for your feedback!