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)

Booking.com extended

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 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

(CHG) Charge Type Codes (OTA 2014B) — Implemented¶

Code Value	Code Name	Comment
1	Per day	Only parking service, internet service
2	Per hour	Only parking service, internet service
7	Per person	Extra services charge per person
10	Per minute	Only internet service
12	Per stay	All except internet service
17	Per week	All except internet service, cleaning fee
19	Per night	All except parking service, internet service
20	Per person per stay	All except parking service, internet service
21	Per person per night	All except parking service, internet service
25	Per room	Extra services charge per room
31	Per unit	Extra services charge per unit

Booking.com extended¶

Code Value	Code Name	Comment
5000	Applicable, charges may vary	Until 1st September 2019 this can be used for all except parking service, internet service. Starting 1st September 2019 this can be used only for electricity fee, gas fee, oil fee, water fee and wood fee.
5001	Charges are applicable	Until 1st September 2019 this can be used only for parking service, internet service. Starting 1st September 2019 this can be used only for electricity fee, gas fee, oil fee, water fee and wood fee.
5002	Charges may apply	Until 1st September 2019 this can be used only for parking service. Starting 1st September 2019 this can be used only for electricity fee, gas fee, oil fee, water fee and wood fee.
5010	Per adult	Extra services charge per adult
5011	Per child	Extra services charge per child
5012	Per infant	Extra services charge per infant
5013	Per senior	Extra services charge per senior
5014	Per bottle	Extra services such as wine or Champagne. Charge per bottle
5015	Per glass	Extra services such as wine or Champagne. Charge per glass
5016	Per ticket	Extra services charge per ticket (e.g. attraction or tour)
5017	Per vehicle	Extra services charge per vehicle (e.g. transport or parking)

Is this page helpful? Yes | No

Thanks for your feedback!