Using maxRatePlanCount

By default, the database returns the first room type in the database record at each property in the initial hotel availability list result. Use maxRatePlanCount to specify the maximum number of room types to return in this list.

A room availability request is still required in order to obtain certain required booking details such as the cancellation policy on a specific room type selection. Use of this element lends the opportunity to obtain all room types at the city list level. If sending a value of 3, then a maximum of 3 room types for each property in the hotel list will be returned.

XML Request Example with maxRatePlanCount=3

http://api.ean.com/ean-services/rs/hotel/v3/list?minorRev=##
&cid=#####
&sig=####################
&apiKey=[xxx-yourOwnKey-xxx]
&customerUserAgent=[xxx]
&customerIpAddress=[xxx]
&customerSessionId=[xxx]
&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>
 <maxRatePlanCount>3</maxRatePlanCount>
 <numberOfResults>1</numberOfResults>

</HotelListRequest>

XML Example Response with 3 room selections (RoomRateDetails nodes) returned

<ns2:HotelListResponse xmlns:ns2="http://v3.hotel.wsapi.ean.com/">
<customerSessionId>0ABAAA49-0CF8-5291-4D02-B8AB6D29613F</customerSessionId>
<numberOfRoomsRequested>1</numberOfRoomsRequested>
<moreResultsAvailable>true</moreResultsAvailable>
<cacheKey>-2d0cf852:14d0b8ab6d2:6141</cacheKey>
<cacheLocation>10.186.170.73:7300</cacheLocation>
<cachedSupplierResponse supplierCacheTolerance="NOT_SUPPORTED" cachedTime="0" supplierRequestNum="231" supplierResponseNum="1" supplierResponseTime="252" candidatePreptime="31" otherOverheadTime="3" 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>
        <address1>3244 139th Ave Se</address1>
        <city>Bellevue</city>
        <stateProvinceCode>WA</stateProvinceCode>
        <postalCode>98005</postalCode>
        <countryCode>US</countryCode>
        <airportCode>SEA</airportCode>
        <supplierType>E</supplierType>
        <propertyCategory>4</propertyCategory>
        <hotelRating>3.0</hotelRating>
        <confidenceRating>85</confidenceRating>
        <amenityMask>142035011</amenityMask>
        <locationDescription>Near Bellevue College</locationDescription>
        <shortDescription>&lt;p&gt;&lt;b&gt;Property Location&lt;/b&gt; &lt;br /&gt;Located in Bellevue, HYATT house Seattle/Bellevue is minutes from Bellevue College and T-Mobile USA Headquarters. This aparthotel is within close proximity of</shortDescription>
        <highRate>189.0</highRate>
        <lowRate>189.0</lowRate>
        <rateCurrencyCode>USD</rateCurrencyCode>
        <latitude>47.58081</latitude>
        <longitude>-122.15468</longitude>
        <proximityDistance>2.9069135</proximityDistance>
        <proximityUnit>MI</proximityUnit>
        <hotelInDestination>true</hotelInDestination>
        <thumbNailUrl>/hotels/2000000/1860000/1852300/1852256/1852256_68_t.jpg</thumbNailUrl>
        <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>b851b693-ca1a-4e70-ac32-e6143e364ac2</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>
            <RoomRateDetails>
                <roomTypeCode>200162494</roomTypeCode>
                <rateCode>200918225</rateCode>
                <maxRoomOccupancy>4</maxRoomOccupancy>
                <quotedRoomOccupancy>2</quotedRoomOccupancy>
                <minGuestAge>0</minGuestAge>
                <roomDescription>Studio, 1 King Bed with Sofabed - 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>c756cd86-306f-4663-8afd-ab66f59c9d03</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="194.00" rate="194.00" promo="false" />
                                    <NightlyRate baseRate="194.00" rate="194.00" promo="false" />
                                </ChargeableNightlyRates>
                            </Room>
                        </RoomGroup>
                        <ChargeableRateInfo averageBaseRate="194.00" averageRate="194.00" commissionableUsdTotal="388.00" currencyCode="USD" maxNightlyRate="194.00" nightlyRateTotal="388.00" surchargeTotal="66.32" total="454.32">
                            <NightlyRatesPerRoom size="2">
                                <NightlyRate baseRate="194.00" rate="194.00" promo="false" />
                                <NightlyRate baseRate="194.00" rate="194.00" promo="false" />
                            </NightlyRatesPerRoom>
                            <Surcharges size="1">
                                <Surcharge type="TaxAndServiceFee" amount="66.32" />
                            </Surcharges>
                        </ChargeableRateInfo>
                        <nonRefundable>true</nonRefundable>
                        <rateType>MerchantStandard</rateType>
                        <currentAllotment>0</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>
            <RoomRateDetails>
                <roomTypeCode>200162487</roomTypeCode>
                <rateCode>200918154</rateCode>
                <maxRoomOccupancy>4</maxRoomOccupancy>
                <quotedRoomOccupancy>2</quotedRoomOccupancy>
                <minGuestAge>0</minGuestAge>
                <roomDescription>Standard Room, 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>ae73d8ac-d4f6-4a2d-91bc-b48a88687ff9</rateKey>
                                <ChargeableNightlyRates>
                                    <NightlyRate baseRate="209.00" rate="209.00" promo="false" />
                                    <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="71.46" total="489.46">
                            <NightlyRatesPerRoom size="2">
                                <NightlyRate baseRate="209.00" rate="209.00" promo="false" />
                                <NightlyRate baseRate="209.00" rate="209.00" promo="false" />
                            </NightlyRatesPerRoom>
                            <Surcharges size="1">
                                <Surcharge type="TaxAndServiceFee" amount="71.46" />
                            </Surcharges>
                        </ChargeableRateInfo>
                        <nonRefundable>true</nonRefundable>
                        <rateType>MerchantStandard</rateType>
                        <currentAllotment>0</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>