Example Basic XML Availability Request for 1 Room

Example responses are truncated to a single hotel for brevity. Dates with a RoomGroup array are required for availability.

http://api.ean.com/ean-services/rs/hotel/v3/list?
apiKey=#####
&cid=#####
&customerIpAddress=#####
&customerUserAgent=######
&customerSessionId=#####
&minorRev=##
&sig=####################
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
    <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>
</HotelListRequest>

XML Response - 1 Room

<ns2:HotelListResponse xmln<ns2:HotelListResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/">
<customerSessionId>0ABAAC28-B197-5914-D0B2-8532CE903E32</customerSessionId>
<numberOfRoomsRequested>1</numberOfRoomsRequested>
<moreResultsAvailable>true</moreResultsAvailable>
<cacheKey>-5c9b1975:14d0b8532ce:-3e26</cacheKey>
<cacheLocation>10.186.172.40:7300</cacheLocation>
<cachedSupplierResponse supplierCacheTolerance="NOT_SUPPORTED" cachedTime="0" supplierRequestNum="231" supplierResponseNum="20" supplierResponseTime="280" candidatePreptime="26" otherOverheadTime="7" tpidUsed="5001" matchedCurrency="true" matchedLocale="true" />
<HotelList size="20" activePropertyCount="231">
    <HotelSummary order="0" ubsScore="371858345">
        <hotelId>119562</hotelId>
        <name>Hotel Andra</name>
        <address1>2000 4th Ave</address1>
        <city>Seattle</city>
        <stateProvinceCode>WA</stateProvinceCode>
        <postalCode>98121</postalCode>
        <countryCode>US</countryCode>
        <airportCode>SEA</airportCode>
        <supplierType>E</supplierType>
        <propertyCategory>1</propertyCategory>
        <hotelRating>4.0</hotelRating>
        <confidenceRating>45</confidenceRating>
        <amenityMask>1446211</amenityMask>
        <locationDescription>Near Pike Place Market</locationDescription>
        <shortDescription>&lt;p&gt;&lt;b&gt;Property Location&lt;/b&gt; &lt;br /&gt;With a stay at Hotel Andra, you&apos;ll be centrally located in Seattle, minutes from Westlake Center and Pike Place Market. This 4-star hotel is within close proximity</shortDescription>
        <highRate>549.0</highRate>
        <lowRate>549.0</lowRate>
        <rateCurrencyCode>USD</rateCurrencyCode>
        <latitude>47.61318</latitude>
        <longitude>-122.34009</longitude>
        <proximityDistance>11.438348</proximityDistance>
        <proximityUnit>MI</proximityUnit>
        <hotelInDestination>true</hotelInDestination>
        <thumbNailUrl>/hotels/1000000/20000/17000/16950/16950_185_t.jpg</thumbNailUrl>
        <deepLink>http://www.travelnow.com/templates/369532/hotels/119562/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>254862</roomTypeCode>
                <rateCode>680894</rateCode>
                <maxRoomOccupancy>2</maxRoomOccupancy>
                <quotedRoomOccupancy>2</quotedRoomOccupancy>
                <minGuestAge>0</minGuestAge>
                <roomDescription>Andra Room, 1 Queen Bed</roomDescription>
                <propertyAvailable>true</propertyAvailable>
                <propertyRestricted>false</propertyRestricted>
                <expediaPropertyId>16950</expediaPropertyId>
                <RateInfos size="1">
                    <RateInfo priceBreakdown="true" promo="false" rateChange="false">
                        <RoomGroup>
                            <Room>
                                <numberOfAdults>2</numberOfAdults>
                                <numberOfChildren>0</numberOfChildren>
                                <rateKey>b2002235-1aec-4752-9947-80c4650b76b0</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="549.00" rate="549.00" promo="false" />
                                    <NightlyRate baseRate="549.00" rate="549.00" promo="false" />
                                </ChargeableNightlyRates>
                            </Room>
                        </RoomGroup>
                        <ChargeableRateInfo averageBaseRate="549.00" averageRate="549.00" commissionableUsdTotal="1098.00" currencyCode="USD" maxNightlyRate="549.00" nightlyRateTotal="1098.00" surchargeTotal="201.42" total="1299.42">
                            <NightlyRatesPerRoom size="2">
                                <NightlyRate baseRate="549.00" rate="549.00" promo="false" />
                                <NightlyRate baseRate="549.00" rate="549.00" promo="false" />
                            </NightlyRatesPerRoom>
                            <Surcharges size="1">
                                <Surcharge type="TaxAndServiceFee" amount="201.42" />
                            </Surcharges>
                        </ChargeableRateInfo>
                        <nonRefundable>false</nonRefundable>
                        <rateType>MerchantStandard</rateType>
                        <currentAllotment>8</currentAllotment>
                    </RateInfo>
                </RateInfos>
            </RoomRateDetails>
        </RoomRateDetailsList>
    </HotelSummary>
    {truncated for brevity}
</HotelList>
</ns2:HotelListResponse>

Example Basic XML Availability Request for 2 Rooms, 1 with children

http://api.ean.com/ean-services/rs/hotel/v3/list?
apiKey=#####
&cid=#####
&customerIpAddress=#####
&customerUserAgent=######
&customerSessionId=#####
&minorRev=##
&sig=####################
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
    <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>
      <Room>
        <numberOfAdults>2</numberOfAdults>
        <numberOfChildren>2</numberOfChildren>
        <childAges>3,6</childAges>
      </Room>
    </RoomGroup>   
</HotelListRequest>

XML Response - 2 Rooms, 1 with children {#4}

<ns2:HotelListResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/">
<customerSessionId>0AB29026-BDB1-DC91-4D02-B64FD0B979C3</customerSessionId>
<numberOfRoomsRequested>2</numberOfRoomsRequested>
<moreResultsAvailable>true</moreResultsAvailable>
<cacheKey>7dbdb1dc:14d0b64fd0b:79d4</cacheKey>
<cacheLocation>10.178.144.38:7300</cacheLocation>
<cachedSupplierResponse supplierCacheTolerance="NOT_SUPPORTED" cachedTime="0" supplierRequestNum="231" supplierResponseNum="20" supplierResponseTime="550" candidatePreptime="29" otherOverheadTime="5" tpidUsed="5001" matchedCurrency="true" matchedLocale="true" />
<HotelList size="20" activePropertyCount="231">
    <HotelSummary order="0" ubsScore="371858175">
        <hotelId>119562</hotelId>
        <name>Hotel Andra</name>
        <address1>2000 4th Ave</address1>
        <city>Seattle</city>
        <stateProvinceCode>WA</stateProvinceCode>
        <postalCode>98121</postalCode>
        <countryCode>US</countryCode>
        <airportCode>SEA</airportCode>
        <supplierType>E</supplierType>
        <propertyCategory>1</propertyCategory>
        <hotelRating>4.0</hotelRating>
        <confidenceRating>45</confidenceRating>
        <amenityMask>1446211</amenityMask>
        <locationDescription>Near Pike Place Market</locationDescription>
        <shortDescription>&lt;p&gt;&lt;b&gt;Property Location&lt;/b&gt; &lt;br /&gt;With a stay at Hotel Andra, you&apos;ll be centrally located in Seattle, minutes from Westlake Center and Pike Place Market. This 4-star hotel is within close proximity</shortDescription>
        <highRate>579.0</highRate>
        <lowRate>579.0</lowRate>
        <rateCurrencyCode>USD</rateCurrencyCode>
        <latitude>47.61318</latitude>
        <longitude>-122.34009</longitude>
        <proximityDistance>11.438348</proximityDistance>
        <proximityUnit>MI</proximityUnit>
        <hotelInDestination>true</hotelInDestination>
        <thumbNailUrl>/hotels/1000000/20000/17000/16950/16950_185_t.jpg</thumbNailUrl>
        <deepLink>http://www.travelnow.com/templates/369532/hotels/119562/overview?lang=en&amp;currency=USD&amp;standardCheckin=8/1/2015&amp;standardCheckout=8/3/2015&amp;roomsCount=2&amp;rooms[0].adultsCount=2&amp;rooms[1].adultsCount=2&amp;rooms[1].childrenCount=2&amp;rooms[1].children[0].age=3&amp;rooms[1].children[1].age=6</deepLink>
        <RoomRateDetailsList>
            <RoomRateDetails>
                <roomTypeCode>91993</roomTypeCode>
                <rateCode>206444</rateCode>
                <maxRoomOccupancy>4</maxRoomOccupancy>
                <quotedRoomOccupancy>2</quotedRoomOccupancy>
                <minGuestAge>0</minGuestAge>
                <roomDescription>Andra Superia Room, 2 Queen Beds</roomDescription>
                <propertyAvailable>true</propertyAvailable>
                <propertyRestricted>false</propertyRestricted>
                <expediaPropertyId>16950</expediaPropertyId>
                <RateInfos size="1">
                    <RateInfo priceBreakdown="true" promo="false" rateChange="false">
                        <RoomGroup>
                            <Room>
                                <numberOfAdults>2</numberOfAdults>
                                <numberOfChildren>0</numberOfChildren>
                                <rateKey>2defb625-cc97-4993-ba43-32d9ba174367</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="579.00" rate="579.00" promo="false" />
                                    <NightlyRate baseRate="579.00" rate="579.00" promo="false" />
                                </ChargeableNightlyRates>
                            </Room>
                            <Room>
                                <numberOfAdults>2</numberOfAdults>
                                <numberOfChildren>2</numberOfChildren>
                                <childAges>3</childAges>
                                <childAges>6</childAges>
                                <rateKey>35a6e391-0cd9-4460-9a7f-f35525691d29</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="579.00" rate="579.00" promo="false" />
                                    <NightlyRate baseRate="579.00" rate="579.00" promo="false" />
                                </ChargeableNightlyRates>
                            </Room>
                        </RoomGroup>
                        <ChargeableRateInfo averageBaseRate="579.00" averageRate="579.00" commissionableUsdTotal="2316.00" currencyCode="USD" maxNightlyRate="579.00" nightlyRateTotal="2316.00" surchargeTotal="424.44" total="2740.44">
                            <NightlyRatesPerRoom size="2">
                                <NightlyRate baseRate="579.00" rate="579.00" promo="false" />
                                <NightlyRate baseRate="579.00" rate="579.00" promo="false" />
                            </NightlyRatesPerRoom>
                            <Surcharges size="1">
                                <Surcharge type="TaxAndServiceFee" amount="424.44" />
                            </Surcharges>
                        </ChargeableRateInfo>
                        <nonRefundable>false</nonRefundable>
                        <rateType>MerchantStandard</rateType>
                        <currentAllotment>16</currentAllotment>
                    </RateInfo>
                </RateInfos>
            </RoomRateDetails>
        </RoomRateDetailsList>
    </HotelSummary>
    {truncated for brevity}
    </HotelList>
</ns2:HotelListResponse>

Page for More Results   {#5}

Send only cacheKey and cacheLocation to page for more results.

http://api.ean.com/ean-services/rs/hotel/v3/list?
apiKey=#####
&cid=#####
&customerIpAddress=#####
&customerUserAgent=######
&customerSessionId=#####
&minorRev=##
&sig=####################
&locale=en_US
&currencyCode=USD
&xml=
<HotelListRequest>
       <cacheKey>633d8539:14933d131a6:-619b</cacheKey>
    <cacheLocation>10.186.170.142:7300</cacheLocation>
</HotelListRequest>

Paging will return the next group of hotel results from your original query. {#6}

<ns2:HotelListResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/">
<customerSessionId>0ABAAA76-030B-8591-4D02-B80456893039</customerSessionId>
<numberOfRoomsRequested>2</numberOfRoomsRequested>
<moreResultsAvailable>true</moreResultsAvailable>
<cacheKey>12030b85:14d0b804568:303d</cacheKey>
<cacheLocation>10.186.170.118:7300</cacheLocation>
<cachedSupplierResponse supplierCacheTolerance="NOT_SUPPORTED" cachedTime="0" supplierRequestNum="166" supplierResponseNum="25" supplierResponseTime="239" candidatePreptime="24" otherOverheadTime="4" tpidUsed="5001" matchedCurrency="true" matchedLocale="true" />
<HotelList size="25" activePropertyCount="166">
    <HotelSummary order="0" ubsScore="346348313">
        <hotelId>117308</hotelId>
        <name>Quality Inn &amp; Suites Hotel Seattle Center</name>
        <address1>618 John Street</address1>
        <city>Seattle</city>
        <stateProvinceCode>WA</stateProvinceCode>
        <postalCode>98109</postalCode>
        <countryCode>US</countryCode>
        <airportCode>SEA</airportCode>
        <supplierType>E</supplierType>
        <propertyCategory>1</propertyCategory>
        <hotelRating>2.5</hotelRating>
        <confidenceRating>89</confidenceRating>
        <amenityMask>1050635</amenityMask>
        <locationDescription>Near Pacific Northwest Ballet</locationDescription>
        <shortDescription>&lt;p&gt;&lt;b&gt;Property Location&lt;/b&gt; &lt;br /&gt;With a stay at Quality Inn &amp; Suites Hotel Seattle Center, you&apos;ll be centrally located in Seattle, minutes from Denny Park and Space Needle. This family-friendly</shortDescription>
        <highRate>209.0</highRate>
        <lowRate>209.0</lowRate>
        <rateCurrencyCode>USD</rateCurrencyCode>
        <latitude>47.62078</latitude>
        <longitude>-122.34375</longitude>
        <proximityDistance>10.952608</proximityDistance>
        <proximityUnit>MI</proximityUnit>
        <hotelInDestination>true</hotelInDestination>
        <thumbNailUrl>/hotels/1000000/70000/64200/64175/64175_171_t.jpg</thumbNailUrl>
        <deepLink>http://www.travelnow.com/templates/369532/hotels/117308/overview?lang=en&amp;currency=USD&amp;standardCheckin=null/null/null&amp;standardCheckout=null/null/null&amp;roomsCount=2&amp;rooms[0].adultsCount=1&amp;rooms[0].childrenCount=1&amp;rooms[0].children[0].age=3&amp;rooms[1].adultsCount=1&amp;rooms[1].childrenCount=1&amp;rooms[1].children[0].age=5</deepLink>
        <RoomRateDetailsList>
            <RoomRateDetails>
                <roomTypeCode>179656</roomTypeCode>
                <rateCode>201323652</rateCode>
                <maxRoomOccupancy>2</maxRoomOccupancy>
                <quotedRoomOccupancy>2</quotedRoomOccupancy>
                <minGuestAge>0</minGuestAge>
                <roomDescription>Standard Room, 1 Queen Bed, Non Smoking</roomDescription>
                <propertyAvailable>true</propertyAvailable>
                <propertyRestricted>false</propertyRestricted>
                <expediaPropertyId>64175</expediaPropertyId>
                <RateInfos size="1">
                    <RateInfo priceBreakdown="true" promo="false" rateChange="false">
                        <RoomGroup>
                            <Room>
                                <numberOfAdults>1</numberOfAdults>
                                <numberOfChildren>1</numberOfChildren>
                                <childAges>3</childAges>
                                <rateKey>71ab89fe-d8fa-4ea8-8a19-45aa2a345eae</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="209.00" rate="209.00" promo="false" />
                                </ChargeableNightlyRates>
                            </Room>
                            <Room>
                                <numberOfAdults>1</numberOfAdults>
                                <numberOfChildren>1</numberOfChildren>
                                <childAges>5</childAges>
                                <rateKey>f3bc122a-af66-444a-abdd-8ded3118d95f</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="209.00" rate="209.00" promo="false" />
                                </ChargeableNightlyRates>
                            </Room>
                        </RoomGroup>
                        <ChargeableRateInfo averageBaseRate="209.00" averageRate="209.00" commissionableUsdTotal="418.00" currencyCode="USD" maxNightlyRate="209.00" nightlyRateTotal="418.00" surchargeTotal="75.90" total="493.90">
                            <NightlyRatesPerRoom size="1">
                                <NightlyRate baseRate="209.00" rate="209.00" promo="false" />
                            </NightlyRatesPerRoom>
                            <Surcharges size="1">
                                <Surcharge type="TaxAndServiceFee" amount="75.90" />
                            </Surcharges>
                        </ChargeableRateInfo>
                        <nonRefundable>false</nonRefundable>
                        <rateType>MerchantStandard</rateType>
                        <currentAllotment>0</currentAllotment>
                    </RateInfo>
                </RateInfos>
                <ValueAdds size="2">
                    <ValueAdd>
                        <description>Continental Breakfast</description>
                    </ValueAdd>
                    <ValueAdd>
                        <description>Free Wireless Internet</description>
                    </ValueAdd>
                </ValueAdds>
            </RoomRateDetails>
        </RoomRateDetailsList>
    </HotelSummary>
    {truncated for brevity}
    </HotelList>
</ns2:HotelListResponse>