Search Home Content API Photo API New! Rates & Availability API Reservations API Promotions API Messaging API Guest Review API New! Opportunity 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?

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 Create rate Create rate(beta) Update rate(beta) Rename rate Deactivate rate Activate rate Create product Create product(beta) Modify product Modify product(beta) Delete product

Managing properties

Section overview Create property Create independent property Modify property contact details Modify property photos Modify property facilities Modify property policies Modify property special bed options Check property content HotelSummary error guidelines Open property Close property 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

Photo API overview Upload photos Retrieve photos Retrieve/modify galleries Self-assessment tutorial

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 Services/Addons 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

Messaging API overview Reply options

Sample requests

Retrieve authorisation tokens Get pending threads Get threads Get messages Send message Mark message as read Mark message as no reply needed

Guest Review API overview

Sample requests

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

Opportunity API overview

Sample requests

Retrieve opportunities Implement/dismiss opportunities

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 Reporting Reporting - Misconduct Categories 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 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

Fields XML Related endpoints

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

Name¶

Fields¶

Field	Description	Type	Min/max	Notes
_Names/ `Name`	Name details for a contact person.	object	0..1	-
_Name/ `@Language`	The contact's spoken language.	BCL	1..1	-
_Name/ `@Gender`	Contact person's gender.	enum	0..1	Accepts: `Male`, `Female`. Default: null. To set as empty, omit the entire attribute (instead of specifying `""`).
_Name/ `GivenName`	Contact person's given name/first name.	string	0..1	At least one of `GivenName` or `SurName` is required.
_Name/ `SurName`	Contact person's last name/family name.	string	0..1	At least one of `GivenName` or `SurName` is required.
_Name/ `JobTitle`	The contact's Booking.com Job Title Code.	BCJT	0..1	-

XML¶

<Name
  Language="en"
  Gender="Male">
  <GivenName>Sam</GivenName>
  <Surname>Xu</Surname>
  <JobTitle>Finance Manager</JobTitle>
</Name>

Related endpoints¶

/ota/OTA_HotelDescriptiveContentNotif

Is this page helpful? Yes | No

Thanks for your feedback!