Option 1

Example Basic XML Availability Request for 1 Room using options=HOTEL_SUMMARY to retrieve the Hotel Summary only

numberOfResults=1 for brevity. Remove this parameter for a default list of 20 or specify how many properties to return on each page. Dates with a RoomGroup array are required for availability.

http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&sig=####################
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
 <options>HOTEL_SUMMARY</options>
 <city>Seattle</city>
 <stateProvinceCode>WA</stateProvinceCode>
 <countryCode>US</countryCode>

 <arrivalDate>08/01/2011</arrivalDate>
 <departureDate>08/03/2011</departureDate>
 <RoomGroup>
  <Room>
   <numberOfAdults>2</numberOfAdults>
  </Room>
 </RoomGroup>
 <numberOfResults>1</numberOfResults>
</HotelListRequest>

Result

<ns2:HotelListResponse>
<customerSessionId>0ABAA825-0BE2-8912-CF12-159D0D9032F8</customerSessionId>
<numberOfRoomsRequested>1</numberOfRoomsRequested>
<moreResultsAvailable>true</moreResultsAvailable>
<cacheKey>-5ac4dd65:12cec68def7:-69b0</cacheKey>
<cacheLocation>10.186.168.44:7306</cacheLocation>
<cachedSupplierResponse matchedLocale="true" matchedCurrency="true" tpidUsed="5001" otherOverheadTime="3" candidatePreptime="62" supplierResponseTime="1354" supplierResponseNum="1" supplierRequestNum="211" cachedTime="0" />
<HotelList size="1">
 <HotelSummary>
 <hotelId>164116</hotelId>
 <name>Sheraton Seattle Hotel</name>
 <street1>1400 6th Ave</street1>
 <city>Seattle</city>
 <stateProvinceCode>WA</stateProvinceCode>
 <postalCode>98101</postalCode>
 <countryCode>US</countryCode>
 <airportCode>SEA</airportCode>
 <supplierType>E</supplierType>
 <propertyCategory>1</propertyCategory>
 <hotelRating>4.0</hotelRating>
 <confidenceRating>35</confidenceRating>
 <amenityMask>17097163</amenityMask>
 <locationDescription>Near 5th Avenue Theater</locationDescription>
 <shortDescription>&lt;p&gt;&lt;strong&gt;Location.&lt;/strong&gt; &lt;br /&gt;Set in the heart of Seattle, this hotel is close to 5th Avenue Theater and Pike
  Place Market, as well as Washington State Convention &amp; Trade Center.  </shortDescription>
 <highRate>239.0</highRate>
 <lowRate>239.0</lowRate>
 <rateCurrencyCode>USD</rateCurrencyCode>
 <latitude>47.61017</latitude>
 <longitude>-122.33357</longitude>
 <proximityDistance>11.115907</proximityDistance>
 <proximityUnit>MI</proximityUnit>
 <hotelInDestination>true</hotelInDestination>
 <thumbNailUrl>/hotels/1000000/30000/25300/25290/25290_36_t.jpg</thumbNailUrl>
 </HotelSummary>
</HotelList>
</ns2:HotelListResponse>

Remove the dates and RoomGroup array to retrieve a dateless list of all active properties for a specific location using options=HOTEL_SUMMARY for Hotel Summary only.

http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&sig=####################
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
 <options>HOTEL_SUMMARY</options>
 <city>Seattle</city>
 <stateProvinceCode>WA</stateProvinceCode>
 <countryCode>US</countryCode>

</HotelListRequest>

Result {#4}

<ns2:HotelListResponse>
<customerSessionId>0ABAA825-0BE2-8912-CF12-159D0D9032F8</customerSessionId>
<numberOfRoomsRequested>0</numberOfRoomsRequested>
<moreResultsAvailable>false</moreResultsAvailable>
<HotelList size="231">
<HotelSummary>
  <hotelId>120955</hotelId>
  <name>Seattle Pacific Hotel</name>
  <street1>325 Aurora Ave N</street1>
  <city>Seattle</city>
  <stateProvinceCode>WA</stateProvinceCode>
  <postalCode>98109</postalCode>
  <countryCode>US</countryCode>
  <airportCode>SEA</airportCode>
  <propertyCategory>1</propertyCategory>
  <hotelRating>1.5</hotelRating>
  <confidenceRating>0</confidenceRating>
  <amenityMask>18568</amenityMask>
  <locationDescription>Near Experience Music Project Museum</locationDescription>
  <shortDescription>
  &lt;p&gt;&lt;strong&gt;Location.&lt;/strong&gt; &lt;br /&gt;Set in the heart of Seattle, this hotel is close to Experience Music Project Museum and Space Needle, as well as Seattle Center. Other attractions include Pike</shortDescription>
  <highRate>109.344</highRate>
  <lowRate>61.0</lowRate>
  <rateCurrencyCode>USD</rateCurrencyCode>
  <latitude>47.62161</latitude>
  <longitude>-122.34375</longitude>
  <proximityDistance>11.683172</proximityDistance>
  <proximityUnit>MI</proximityUnit>
  <hotelInDestination>true</hotelInDestination>
  <thumbNailUrl>/hotels/1000000/60000/58800/58713/58713_12_t.jpg</thumbNailUrl>
</HotelSummary>

...shortened list for brevity...

</HotelList>
</ns2:HotelListResponse>

Option 2

Example Basic XML Availability Request for 1 Room using options=ROOM_RATE_DETAILS to retrieve the Room Rate Details only

numberOfResults=1 for brevity. Remove this parameter for a default list of 20 or specify how many properties to return on each page. Dates with a RoomGroup array are required for availability.

http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&sig=####################
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
 <options>ROOM_RATE_DETAILS</options>
 <city>Seattle</city>
 <stateProvinceCode>WA</stateProvinceCode>
 <countryCode>US</countryCode>

 <arrivalDate>08/01/2015</arrivalDate>
 <departureDate>08/03/2015</departureDate>
 <RoomGroup>
  <Room>
   <numberOfAdults>2</numberOfAdults>
  </Room>
 </RoomGroup>
 <numberOfResults>1</numberOfResults>

</HotelListRequest>

Result

The below result includes an Expedia Collect property which is identified by supplierType=E.  Expedia Collect properties are sold through the Expedia inventory system.

<ns2:HotelListResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/">
<customerSessionId>0ABAAA3A-D2E7-7C91-4D02-B736812969AC</customerSessionId>
<numberOfRoomsRequested>1</numberOfRoomsRequested>
<moreResultsAvailable>true</moreResultsAvailable>
<cacheKey>-53d2e77c:14d0b736812:69b4</cacheKey>
<cacheLocation>10.186.170.58:7300</cacheLocation>
<cachedSupplierResponse supplierCacheTolerance="NOT_SUPPORTED" cachedTime="0" supplierRequestNum="231" supplierResponseNum="1" supplierResponseTime="255" candidatePreptime="37" otherOverheadTime="5" tpidUsed="5001" matchedCurrency="true" matchedLocale="true" />
<HotelList size="1" activePropertyCount="231">
    <HotelSummary order="0" ubsScore="372138480">
        <hotelId>263112</hotelId>
        <supplierType>E</supplierType>
        <highRate>189.0</highRate>
        <lowRate>189.0</lowRate>
        <rateCurrencyCode>USD</rateCurrencyCode>
        <RoomRateDetailsList>
            <RoomRateDetails>
                <roomTypeCode>200162510</roomTypeCode>
                <rateCode>200918338</rateCode>
                <maxRoomOccupancy>2</maxRoomOccupancy>
                <quotedRoomOccupancy>2</quotedRoomOccupancy>
                <minGuestAge>0</minGuestAge>
                <roomDescription>Studio, 1 King Bed - Advance Purchase</roomDescription>
                <propertyAvailable>true</propertyAvailable>
                <propertyRestricted>false</propertyRestricted>
                <expediaPropertyId>1852256</expediaPropertyId>
                <RateInfos size="1">
                    <RateInfo priceBreakdown="true" promo="false" rateChange="false">
                        <RoomGroup>
                            <Room>
                                <numberOfAdults>2</numberOfAdults>
                                <numberOfChildren>0</numberOfChildren>
                                <rateKey>499d8c1c-a1d3-45e1-bb98-11b3c9386e70</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="189.00" rate="189.00" promo="false" />
                                    <NightlyRate baseRate="189.00" rate="189.00" promo="false" />
                                </ChargeableNightlyRates>
                            </Room>
                        </RoomGroup>
                        <ChargeableRateInfo averageBaseRate="189.00" averageRate="189.00" commissionableUsdTotal="378.00" currencyCode="USD" maxNightlyRate="189.00" nightlyRateTotal="378.00" surchargeTotal="64.60" total="442.60">
                            <NightlyRatesPerRoom size="2">
                                <NightlyRate baseRate="189.00" rate="189.00" promo="false" />
                                <NightlyRate baseRate="189.00" rate="189.00" promo="false" />
                            </NightlyRatesPerRoom>
                            <Surcharges size="1">
                                <Surcharge type="TaxAndServiceFee" amount="64.60" />
                            </Surcharges>
                        </ChargeableRateInfo>
                        <nonRefundable>true</nonRefundable>
                        <rateType>MerchantStandard</rateType>
                        <currentAllotment>39</currentAllotment>
                    </RateInfo>
                </RateInfos>
                <ValueAdds size="3">
                    <ValueAdd>
                        <description>Continental Breakfast</description>
                    </ValueAdd>
                    <ValueAdd>
                        <description>Free Parking</description>
                    </ValueAdd>
                    <ValueAdd>
                        <description>Free Wireless Internet</description>
                    </ValueAdd>
                </ValueAdds>
            </RoomRateDetails>
        </RoomRateDetailsList>
    </HotelSummary>
</HotelList>
</ns2:HotelListResponse>

Remove the dates and RoomGroup array to retrieve a dateless list of all active properties for a specific location using options=ROOM_RATE_DETAILS for Room Rate Details only.

http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&sig=####################
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
   <options>ROOM_RATE_DETAILS</options>
 <city>Seattle</city>
 <stateProvinceCode>WA</stateProvinceCode>
 <countryCode>US</countryCode>

</HotelListRequest>

Result

<ns2:HotelListResponse>
<customerSessionId>0ABAA825-0BE2-8912-CF12-159D0D9032F8</customerSessionId>
<numberOfRoomsRequested>0</numberOfRoomsRequested>
<moreResultsAvailable>false</moreResultsAvailable>
<HotelList size="231">
  <HotelSummary>
    <hotelId>120955</hotelId>
    <highRate>109.344</highRate>
    <lowRate>61.0</lowRate>
    <rateCurrencyCode>USD</rateCurrencyCode>
  </HotelSummary>
  <HotelSummary>
    <hotelId>112182</hotelId>
    <highRate>300.0386</highRate>
    <lowRate>144.9973</lowRate>
    <rateCurrencyCode>USD</rateCurrencyCode>
</HotelSummary>

...shortened list for brevity...

</HotelList>
</ns2:HotelListResponse>

Options 3

Example Basic XML Availability Request for 1 Room using options=DEEP_LINKS to retrieve Deep Links only

numberOfResults=1 for brevity. Remove this parameter for a default list of 20 or specify how many properties to return on each page. Dates with a RoomGroup array are required for availability.

http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&sig=####################
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
 <options>DEEP_LINKS</options>
 <city>Seattle</city>
    <stateProvinceCode>WA</stateProvinceCode>
    <countryCode>US</countryCode>
    <arrivalDate>08/01/2011</arrivalDate>
    <departureDate>08/03/2011</departureDate>
    <RoomGroup>
      <Room>
        <numberOfAdults>2</numberOfAdults>
      </Room>
    </RoomGroup>
 <numberOfResults>1</numberOfResults>

</HotelListRequest>

Result

<ns2:HotelListResponse>
<customerSessionId>0ABAA825-0BE2-8912-CF12-159D0D9032F8</customerSessionId>
<numberOfRoomsRequested>1</numberOfRoomsRequested>
<moreResultsAvailable>true</moreResultsAvailable>
<cacheKey>-5271a6bc:12d8a7f58bd:1876</cacheKey>
<cacheLocation>10.186.168.113:7305</cacheLocation>
<HotelList size="1">
<HotelSummary>
  <hotelId>164122</hotelId>
  <supplierType>E</supplierType>
  <highRate>262.65</highRate>
  <lowRate>262.65</lowRate>
  <rateCurrencyCode>USD</rateCurrencyCode>
  <deepLink>
  http://travel.ian.com/index.jsp?pageName=hotAvail&cid=#####&hotelID=164122&mode=2&numberOfRooms=1&room-0-adult-total=2&room-0-child-total=0&arrivalMonth=7&arrivalDay=1&departureMonth=7&departureDay=3&showInfo=true&locale=en_US&currencyCode=USD
  </deepLink>
</HotelSummary>
</HotelList>
</ns2:HotelListResponse>

Remove the dates and RoomGroup array to retrieve a dateless list of all active properties for a specific location using options=3 for Deep Links only.

http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&sig=####################
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
  <options>DEEP_LINKS</options>
  <city>Seattle</city>
  <stateProvinceCode>WA</stateProvinceCode>
  <countryCode>US</countryCode>

</HotelListRequest>

Result

<ns2:HotelListResponse>
<customerSessionId>0ABAA825-0BE2-8912-CF12-159D0D9032F8</customerSessionId>
<numberOfRoomsRequested>0</numberOfRoomsRequested>
<moreResultsAvailable>false</moreResultsAvailable>
<HotelList size="231">
<HotelSummary>
    <hotelId>120955</hotelId>
    <highRate>109.344</highRate>
    <lowRate>61.0</lowRate>
    <rateCurrencyCode>USD</rateCurrencyCode>
    <deepLink>
    http://travel.ian.com/index.jsp?pageName=hotAvail&cid=#####&hotelID=120955&mode=2&numberOfRooms=1&room-0-adult-total=2&showInfo=true&locale=en_US&currencyCode=USD
    </deepLink>
  </HotelSummary>
  <HotelSummary>
    <hotelId>112182</hotelId>
    <highRate>300.0386</highRate>
    <lowRate>144.9973</lowRate>
    <rateCurrencyCode>USD</rateCurrencyCode>
    <deepLink>
    http://travel.ian.com/index.jsp?pageName=hotAvail&cid=#####&hotelID=112182&mode=2&numberOfRooms=1&room-0-adult-total=2&showInfo=true&locale=en_US&currencyCode=USD
    </deepLink>
  </HotelSummary>

  ...shortened list for brevity...

</HotelList>
</ns2:HotelListResponse>

numberOfResults=1 for brevity. Remove this parameter for a default list of 20 or specify how many properties to return on each page. Dates with a RoomGroup array are required for availability.

http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&sig=####################
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
 <options>ROOM_RATE_DETAILS,DEEP_LINKS</options>
 <city>Seattle</city>
    <stateProvinceCode>WA</stateProvinceCode>
    <countryCode>US</countryCode>
    <arrivalDate>08/01/2011</arrivalDate>
    <departureDate>08/03/2011</departureDate>
    <RoomGroup>
      <Room>
        <numberOfAdults>2</numberOfAdults>
      </Room>
    </RoomGroup>
 <numberOfResults>1</numberOfResults>

</HotelListRequest>

Result

<ns2:HotelListResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/">
<customerSessionId>0ABAAACC-5E64-3914-D0B2-8F1D23904F8B</customerSessionId>
<numberOfRoomsRequested>1</numberOfRoomsRequested>
<moreResultsAvailable>true</moreResultsAvailable>
<cacheKey>-2575e643:14d0b8f1d23:-4f7b</cacheKey>
<cacheLocation>10.186.170.204:7300</cacheLocation>
<cachedSupplierResponse supplierCacheTolerance="NOT_SUPPORTED" cachedTime="0" supplierRequestNum="231" supplierResponseNum="1" supplierResponseTime="280" candidatePreptime="22" otherOverheadTime="10" tpidUsed="5001" matchedCurrency="true" matchedLocale="true" />
<HotelList size="1" activePropertyCount="231">
    <HotelSummary order="0" ubsScore="372138480">
        <hotelId>263112</hotelId>
        <name>HYATT house Seattle/Bellevue</name>
        <supplierType>E</supplierType>
        <highRate>189.0</highRate>
        <lowRate>189.0</lowRate>
        <rateCurrencyCode>USD</rateCurrencyCode>
        <deepLink>http://www.travelnow.com/templates/369532/hotels/263112/overview?lang=en&amp;currency=USD&amp;standardCheckin=8/1/2015&amp;standardCheckout=8/3/2015&amp;roomsCount=1&amp;rooms[0].adultsCount=2</deepLink>
        <RoomRateDetailsList>
            <RoomRateDetails>
                <roomTypeCode>200162510</roomTypeCode>
                <rateCode>200918338</rateCode>
                <maxRoomOccupancy>2</maxRoomOccupancy>
                <quotedRoomOccupancy>2</quotedRoomOccupancy>
                <minGuestAge>0</minGuestAge>
                <roomDescription>Studio, 1 King Bed - Advance Purchase</roomDescription>
                <propertyAvailable>true</propertyAvailable>
                <propertyRestricted>false</propertyRestricted>
                <expediaPropertyId>1852256</expediaPropertyId>
                <RateInfos size="1">
                    <RateInfo priceBreakdown="true" promo="false" rateChange="false">
                        <RoomGroup>
                            <Room>
                                <numberOfAdults>2</numberOfAdults>
                                <numberOfChildren>0</numberOfChildren>
                                <rateKey>c0424b50-dc39-4068-b55a-1393531173b6</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="189.00" rate="189.00" promo="false" />
                                    <NightlyRate baseRate="189.00" rate="189.00" promo="false" />
                                </ChargeableNightlyRates>
                            </Room>
                        </RoomGroup>
                        <ChargeableRateInfo averageBaseRate="189.00" averageRate="189.00" commissionableUsdTotal="378.00" currencyCode="USD" maxNightlyRate="189.00" nightlyRateTotal="378.00" surchargeTotal="64.60" total="442.60">
                            <NightlyRatesPerRoom size="2">
                                <NightlyRate baseRate="189.00" rate="189.00" promo="false" />
                                <NightlyRate baseRate="189.00" rate="189.00" promo="false" />
                            </NightlyRatesPerRoom>
                            <Surcharges size="1">
                                <Surcharge type="TaxAndServiceFee" amount="64.60" />
                            </Surcharges>
                        </ChargeableRateInfo>
                        <nonRefundable>true</nonRefundable>
                        <rateType>MerchantStandard</rateType>
                        <currentAllotment>39</currentAllotment>
                    </RateInfo>
                </RateInfos>
                <ValueAdds size="3">
                    <ValueAdd>
                        <description>Continental Breakfast</description>
                    </ValueAdd>
                    <ValueAdd>
                        <description>Free Parking</description>
                    </ValueAdd>
                    <ValueAdd>
                        <description>Free Wireless Internet</description>
                    </ValueAdd>
                </ValueAdds>
            </RoomRateDetails>
        </RoomRateDetailsList>
    </HotelSummary>
</HotelList>
</ns2:HotelListResponse>
http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
 <options>ROOM_RATE_DETAILS,DEEP_LINKS</options>
 <city>Seattle</city>
 <stateProvinceCode>WA</stateProvinceCode>
 <countryCode>US</countryCode>

</HotelListRequest>

Result

<ns2:HotelListResponse>
<customerSessionId>0ABAA825-0BE2-8912-CF12-159D0D9032F8</customerSessionId>
<numberOfRoomsRequested>0</numberOfRoomsRequested>
<moreResultsAvailable>false</moreResultsAvailable>
<HotelList size="231">
<HotelSummary>
  <hotelId>120955</hotelId>
  <highRate>109.344</highRate>
  <lowRate>61.0</lowRate>
  <rateCurrencyCode>USD</rateCurrencyCode>
  <deepLink>
  http://travel.ian.com/index.jsp?pageName=hotAvail&cid=#####&hotelID=120955&mode=2&numberOfRooms=1&room-0-adult-total=2&showInfo=true&locale=en_US&currencyCode=USD
  </deepLink>
</HotelSummary>

...shortened for brevity...

</HotelList>
</ns2:HotelListResponse>