/ota/OTA_HotelDescriptiveContentNotif

Use this endpoint to create or modify the "skeleton" of a property. This skeleton contains the property's location details, policies, contact details, property-level photos, and more.

Tutorial

If you're new to creating properties with the API, try our tutorial!

Methods

POST https://supply-xml.booking.com/hotels/ota/OTA_HotelDescriptiveContentNotif

Headers

Header Description Type Required Notes
Authorization Machine account username and password string Required Example: Authorization: Basic {username:password}

Examples


Full XML sample

For reference, here is a sample request body containing all possible fields. The root-level object is OTA_HotelDescriptiveContentNotifRQ.

<?xml version="1.0" encoding="UTF-8"?>
<OTA_HotelDescriptiveContentNotifRQ xmlns="http://www.opentravel.org/OTA/2003/05" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" PrimaryLangID="en-us" EchoToken="GUID" TimeStamp="2015-06-09T09:30:47Z" xsi:schemaLocation="http://www.opentravel.org/2014B/OTA_HotelDescriptiveContentNotifRQ.xsd" id="OTA2014B" Version="8.0" Target="Test">
  <HotelDescriptiveContents>
   <HotelDescriptiveContent HotelName="Fake Hotel" ID="101010" LanguageCode="en" PropertyLicenseNumber="AB-CD-1234" HotelDescriptiveContentNotifType="New">
     <ContactInfos>
       <ContactInfo ContactProfileType="PhysicalLocation">
         <Addresses>
           <Address>
             <AddressLine>15 Station Street</AddressLine>
             <CityName>Sotteville</CityName>
             <PostalCode>76000</PostalCode>
             <CountryName>FR</CountryName>
           </Address>
           <Address Language="fr">
             <HotelName>Le Faux Hôtel 001</HotelName>
             <CityName>Sotteville-lès-Rouen</CityName>
             <CountryName>FR</CountryName>
             <PostalCode>76000</PostalCode>
             <AddressLine>15 Rue de la Gare</AddressLine>
           </Address>
         </Addresses>
       </ContactInfo>
       <ContactInfo ContactProfileType="availability" Index="1">
         <Names>
           <Name Language="en" Gender="Male">
             <GivenName>Steve</GivenName>
             <Surname>Martin</Surname>
             <JobTitle>Administration Employee</JobTitle>
           </Name>
         </Names>
         <Addresses>
           <Address>
             <AddressLine>200 rue de Paris</AddressLine>
             <CityName>Sotteville</CityName>
             <CountryName>FR</CountryName>
             <PostalCode>76000</PostalCode>
           </Address>
         </Addresses>
         <Emails>
           <Email>admin@fakehotel.com</Email>
         </Emails>
         <Phones>
           <Phone PhoneNumber="+3362211110" PhoneTechType="1" Extension="30" />
           <Phone PhoneNumber="+3362211111" PhoneTechType="1" Extension="30" />
           <Phone PhoneNumber="+3362211112" PhoneTechType="1" Extension="30" />
           <Phone PhoneNumber="+3362211113" PhoneTechType="5" />
           <Phone PhoneNumber="+3362211114" PhoneTechType="3" />
         </Phones>
       </ContactInfo>
       <ContactInfo ContactProfileType="invoices">
         <Names>
           <Name>
             <GivenName>Carol</GivenName>
             <Surname>Xu</Surname>
           </Name>
         </Names>
         <Addresses>
           <Address>
             <AddressLine>1000 Eighth Avenue</AddressLine>
             <CityName>New York</CityName>
             <PostalCode>10000</PostalCode>
             <StateProv StateCode="NY" />
             <CountryName>US</CountryName>
           </Address>
         </Addresses>
         <Emails>
           <Email>carol.xu@fakehotel.com</Email>
         </Emails>
         <Phones>
           <Phone PhoneNumber="+3162222220" PhoneTechType="1" Extension="30" />
         </Phones>
       </ContactInfo>
       <ContactInfo ContactProfileType="availability" Index="2">
         <Names>
           <Name Language="xt" Gender="Female">
             <GivenName>Carol</GivenName>
             <Surname>Xu</Surname>
             <JobTitle>Owner</JobTitle>
           </Name>
         </Names>
         <Addresses>
           <Address>
             <AddressLine>1000 Eighth Avenue</AddressLine>
             <CityName>New York</CityName>
             <PostalCode>10000</PostalCode>
             <StateProv StateCode="NY" />
             <CountryName>US</CountryName>
           </Address>
         </Addresses>
         <Emails>
           <Email>carol.xu@fakehotel.com</Email>
         </Emails>
         <Phones>
           <Phone PhoneNumber="+3162222220" PhoneTechType="1" Extension="30" />
           <Phone PhoneNumber="+3162222221" PhoneTechType="1" Extension="30" />
           <Phone PhoneNumber="+3162222222" PhoneTechType="1" Extension="30" />
           <Phone PhoneNumber="+3162222223" PhoneTechType="5" />
           <Phone PhoneNumber="+3162222224" PhoneTechType="3" />
         </Phones>
       </ContactInfo>
     </ContactInfos>
     <HotelInfo>
       <CategoryCodes>
         <GuestRoomInfo Quantity="100" />
         <HotelCategory ExistsCode="1" Code="20" />
       </CategoryCodes>
       <Languages>
         <Language LanguageCode="fr" />
         <Language LanguageCode="en" />
       </Languages>
       <Position Latitude="49.4092" Longitude="1.0900" />
       <Services>
         <Service Code="5" Included="false" />
         <Service Code="173" Price="14" CurrencyCode="EUR">
          <Types>
            <Type Code="5001" />
            <Type Code="5004" />
            <Type Code="5009" />
          </Types>
         </Service>
         <Service Code="218" ExistsCode="1" Quantity="2">
           <Features>
             <Feature>
               <DescriptiveText>max_age_12</DescriptiveText>
               <Charge Amount="12300" DecimalPlaces="2"/>
             </Feature>
           </Features>
         </Service>
         <Service Code="5038" Quantity="4" >
           <Features>
             <Feature ID="adult_bed">
               <Charge Amount="123"/>
             </Feature>
             <Feature ID="infant_bed">
               <Charge Amount="321"/>
             </Feature>
             <Feature ID="children_bed">
               <DescriptiveText>max_age_6</DescriptiveText>
               <Charge Amount="246"/>
             </Feature>
           </Features>
         </Service>
       </Services>
       <OwnershipManagementInfos>
         <OwnershipManagementInfo>
           <CompanyName Code="1234" />
         </OwnershipManagementInfo>
       </OwnershipManagementInfos>
       <RelativePositions>
         <RelativePosition>
           <Transportations>
             <Transportation>
               <TPA_Extensions>
                 <Route>
                   <Leg>
                     <Start Type='airport' Code='AMS' />
                     <TransportType Code='5000' />
                     <Departure UponArrangement='1' />
                   </Leg>
                   <JourneyTime Minutes='20' />
                   <Price Amount='10' CurrencyCode='EUR' />
                 </Route>
               </TPA_Extensions>
             </Transportation>
             <Transportation>
               <TPA_Extensions>
                 <Route>
                   <Leg>
                     <Start Type='airport' Code='AMS' />
                     <TransportType Code='3' />
                     <Line Name='10'/>
                     <Departure Interval='20' />
                   </Leg>
                   <JourneyTime Minutes='20' />
                   <Price Amount='5.5' CurrencyCode='EUR' />
                 </Route>
               </TPA_Extensions>
             </Transportation>
             <Transportation>
               <TPA_Extensions>
                 <Route>
                   <Leg>
                     <Start Type='airport' Code='AMS' />
                     <TransportType Code='5' />
                     <Motorway Name='A2'/>
                     <Junction Name='Amsterdam Zuid' />
                   </Leg>
                   <JourneyTime Minutes='30' />
                 </Route>
               </TPA_Extensions>
             </Transportation>
           </Transportations>
         </RelativePosition>
       </RelativePositions>
       <TPA_Extensions>
         <AcceptedPayments>
           <AcceptedPayment PaymentTypeCode="1" />
           <AcceptedPayment PaymentTypeCode="2" />
           <AcceptedPayment PaymentTypeCode="3" />
         </AcceptedPayments>
         <HotelierMessage Language="en">Our hotel defies gravity and floats in mid-air ...
         </HotelierMessage>
       </TPA_Extensions>
     </HotelInfo>
     <FacilityInfo>
       <GuestRooms>
         <GuestRoom>
           <Amenities>
             <Amenity RoomAmenityCode="91" Quantity="4" />
           </Amenities>
         </GuestRoom>
       </GuestRooms>
       <Restaurants>
         <Restaurant RestaurantName='Orient' OfferBreakfast='1' OfferDinner='1'>
           <CuisineCodes>
             <CuisineCode Code='1'/>
             <CuisineCode Code='5000'/>
           </CuisineCodes>
           <OperationSchedules>
             <OperationSchedule>
               <OperationTimes>
                 <OperationTime Mon='1' Tue='1' Thur='1' Fri='1' Start='16:00' End='22:00' />
                 <OperationTime Weds='1' Sun='1' Start='14:00' End='18:00' />
               </OperationTimes>
             </OperationSchedule>
           </OperationSchedules>
           <Features>
             <Feature DescriptiveText='a la carte'/>
             <Feature DescriptiveText='buffet'/>
             <Feature DescriptiveText='guests only'/>
             <Feature DescriptiveText='accepts reservations'/>
             <Feature DescriptiveText='outdoor seating'/>
           </Features>
           <TPA_Extensions>
             <Ambiances>
               <Ambiance Name='modern'/>
             </Ambiances>
             <DietaryOptions>
               <DietaryOption Name='halal'/>
               <DietaryOption Name='vegan'/>
             </DietaryOptions>
           </TPA_Extensions>
         </Restaurant>
       </Restaurants>
       <TPA_Extensions>
         <HotelierMessage Language="en">We use jetpacks to go for weekend joyrides with our guests ...
         </HotelierMessage>
       </TPA_Extensions>
     </FacilityInfo>
     <AreaInfo>
       <TPA_Extensions>
         <HotelierMessage Language="en">We float above the heart of the city with easy access to ...
         </HotelierMessage>
       </TPA_Extensions>
       <Attractions>
         <Attraction AttractionName="test_market" AttractionCategoryCode="29" Distance="1.2" DistanceUnit="miles" LanguageCode="en"/>
         <Attraction AttractionName="test_restaurant" AttractionCategoryCode="41" Distance="3"/>
       </Attractions>
     </AreaInfo>
     <Policies>
       <Policy>
         <PolicyInfo CheckInTime="17:00-20:00" CheckOutTime="12:00" />
         <PetsPolicies PetsAllowedCode="Pets By Arrangements">
           <PetsPolicy NonRefundableFee="5" />
         </PetsPolicies>
         <CancelPolicy>
           <CancelPenalty PolicyCode="1">
             <TPA_Extensions>
               <NoShowPolicy Penalty="default" />
             </TPA_Extensions>
           </CancelPenalty>
           <CancelPenalty PolicyCode="29">
             <TPA_Extensions>
               <NoShowPolicy Penalty="total_price" />
             </TPA_Extensions>
           </CancelPenalty>
         </CancelPolicy>
         <GuaranteePaymentPolicy>
           <GuaranteePayment PolicyCode="1">
             <TPA_Extensions>
               <PrepaymentPolicy EffectiveFrom="after_reservation_is_made" />
             </TPA_Extensions>
           </GuaranteePayment>
           <GuaranteePayment PolicyCode="29">
             <TPA_Extensions>
               <PrepaymentPolicy EffectiveFrom="after_cancellation_fee_begins" />
             </TPA_Extensions>
           </GuaranteePayment>
         </GuaranteePaymentPolicy>
         <TaxPolicies>
           <TaxPolicy Code="36" Percent="1200" DecimalPlaces="2" Type="Exclusive"/>
           <TaxPolicy Code="3" Amount="800" DecimalPlaces="2" Type="Inclusive" ChargeFrequency="20" />
         </TaxPolicies>
         <FeePolicies>
           <FeePolicy Code="5009" Amount="1500" DecimalPlaces="2" Type="Conditional" ChargeFrequency="12" >
             <TPA_Extensions>
               <Conditions>
                 <Condition Type="guest_doesnt_clean_before_checkout" />
               </Conditions>
             </TPA_Extensions>
           </FeePolicy>
           <FeePolicy Code="5035" Amount="10000" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="5001" >
             <TPA_Extensions>
               <InternetFeePolicy InternetType="wired" InternetCoverage="public_areas" />
             </TPA_Extensions>
           </FeePolicy>
           <FeePolicy Code="5036" Amount="10000" DecimalPlaces="2" Type="Exclusive" ChargeFrequency="2" >
             <TPA_Extensions>
               <ParkingFeePolicy ParkingType="location_nearby" ParkingReservation="needed" ParkingProperty="private"/>
             </TPA_Extensions>
           </FeePolicy>
         </FeePolicies>
       </Policy>
     </Policies>
     <AffiliationInfo>
       <Awards>
         <Award Provider="Star rating" Rating="3" />
       </Awards>
     </AffiliationInfo>
     <MultimediaDescriptions>
       <MultimediaDescription>
         <ImageItems>
           <ImageItem>
             <ImageFormat Main="1">
               <URL>https://pathtoimage/hotelimage001.jpg</URL>
             </ImageFormat>
             <TPA_Extensions>
               <ImageTags>
                 <ImageTag ID="1"/>
               </ImageTags>
             </TPA_Extensions>
           </ImageItem>
           <ImageItem>
             <ImageFormat Sort="1">
               <URL>https://pathtoimage/hotelimage002.jpg</URL>
             </ImageFormat>
           </ImageItem>
         </ImageItems>
       </MultimediaDescription>
     </MultimediaDescriptions>
     <TPA_Extensions>
       <!-- Standard Phrases -->
       <StandardPhrases>
         <StandardPhrase Name="KeyCollection" Enabled="1">
           <Options>
             <Option Name="KeyCollectionAddressLine">15 Station Street</Option>
             <Option Name="KeyCollectionCityName">Sotteville</Option>
             <Option Name="KeyCollectionPostalCode">76000</Option>
           </Options>
         </StandardPhrase>
         <StandardPhrase Name="GuestIdentification" Enabled="1"/>
         <StandardPhrase Name="InformArrivalTime" Enabled="1"/>
         <StandardPhrase Name="PayBeforeStay" Enabled="1"/>
         <StandardPhrase Name="TattooRestriction" Enabled="1"/>
         <StandardPhrase Name="Renovation" Enabled="1">
           <Options>
             <Option Name="RenovationFrom">2017-01-01</Option>
             <Option Name="RenovationUntil">2017-12-31</Option>
           </Options>
         </StandardPhrase>
         <StandardPhrase Name="SecurityDeposit" Enabled="1">
           <Options>
             <Option Name="SecurityDepositAmount">10.43</Option>
           </Options>
         </StandardPhrase>
       </StandardPhrases>
     </TPA_Extensions>
   </HotelDescriptiveContent>
 </HotelDescriptiveContents>
</OTA_HotelDescriptiveContentNotifRQ>