Get rate restrictions – OTA_HotelAvailGetRQ

Usually hotels have different rates with various min/max stay, no check-in, no check-out policies. To retrieve that information you should use OTA_HotelAvailGetRQ call.

Request sample

<OTA_HotelAvailGetRQ xmlns="http://www.opentravel.org/OTA/2003/05" Version="1.003">
    <POS />
    <HotelAvailRequests>
        <HotelAvailRequest>
            <DateRange Start="2010-12-25" End="2011-01-03" />
            <HotelRef HotelCode="604" />
        </HotelAvailRequest>
    </HotelAvailRequests>
</OTA_HotelAvailGetRQ>

Required fields:
Version – OTA requires it
DateRange – Data range to get an availability
HotelCode – Hotel ID

Response sample

<OTA_HotelAvailGetRS>
    <Success/>
    <AvailStatusMessages HotelCode="604">
        <AvailStatusMessage>
            <StatusApplicationControl Start="2011-12-25" RatePlanCode="331" InvTypeCode="C_630" End="2012-01-02"/>
            <LengthsOfStay>
                <LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="2" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="3" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="4" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="5" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="6" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="7" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="8" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"></LengthOfStay>
            <LengthOfStay Time="9" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"></LengthOfStay>
            </LengthsOfStay>
        </AvailStatusMessage>
        <AvailStatusMessage>
            <StatusApplicationControl Start="2011-12-25" RatePlanCode="331" InvTypeCode="C_631" End="2012-01-02"/>
            <LengthsOfStay>
                <LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="2" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="3" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="4" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="5" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="6" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="7" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="8" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"></LengthOfStay>
                <LengthOfStay Time="9" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"></LengthOfStay>
            </LengthsOfStay>
        </AvailStatusMessage>
        <AvailStatusMessage>
            <StatusApplicationControl Start="2011-12-25" RatePlanCode="331" InvTypeCode="C_632" End="2012-01-02"/>
            <LengthsOfStay>
                <LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="2" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="3" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="4" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="5" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="6" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="true"/>
                <LengthOfStay Time="7" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="true"/>
                <LengthOfStay Time="8" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="9" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
            </LengthsOfStay>
        </AvailStatusMessage>
        <AvailStatusMessage>
            <StatusApplicationControl Start="2011-12-25" RatePlanCode="331" InvTypeCode="C_633" End="2012-01-02"/>
            <LengthsOfStay>
                <LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="2" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="3" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="4" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="5" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="6" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="7" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="8" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="9" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
            </LengthsOfStay>
        </AvailStatusMessage>
        <AvailStatusMessage>
            <StatusApplicationControl Start="2011-12-25" RatePlanCode="331" InvTypeCode="C_634" End="2012-01-02"/>
            <LengthsOfStay>
                <LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="2" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="3" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="4" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="5" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="6" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="7" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="8" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="9" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
            </LengthsOfStay>
        </AvailStatusMessage>
        <AvailStatusMessage>
            <StatusApplicationControl Start="2011-12-25" RatePlanCode="331" InvTypeCode="C_635" End="2012-01-02"/>
            <LengthsOfStay>
                <LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="2" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="3" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="4" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="5" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="6" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="7" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="8" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="9" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
            </LengthsOfStay>
        </AvailStatusMessage>
        <AvailStatusMessage>
            <StatusApplicationControl Start="2011-12-25" RatePlanCode="331" InvTypeCode="C_636" End="2012-01-02"/>
            <LengthsOfStay>
                <LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="2" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="3" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="4" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="5" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="6" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="7" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="8" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="9" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
            </LengthsOfStay>
        </AvailStatusMessage>
        <AvailStatusMessage>
            <StatusApplicationControl Start="2011-12-25" RatePlanCode="331" InvTypeCode="C_637" End="2012-01-02"/>
            <LengthsOfStay>
                <LengthOfStay Time="1" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="2" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="3" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="4" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="5" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="false" NoCheckout="false"/>
                <LengthOfStay Time="6" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="7" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="4" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="8" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
                <LengthOfStay Time="9" TimeUnit="Day" MinMaxMessageType="FullPatternLOS" MinLOS="0" MaxLOS="0" NoCheckin="true" NoCheckout="false"/>
            </LengthsOfStay>
        </AvailStatusMessage>
    </AvailStatusMessages>
</OTA_HotelAvailGetRS>

Response fields explained:
HotelCode – Hotel ID
StatusApplicationControl – showing the rate and room category information on selected time span
Start – Check-in date
End – Check-out date
RatePlanCode – Rate plan code
InvTypeCode – Room Category Code. Note it starts from C for hotel rooms and from P for apartments and virtual units
LengthOfStay – Min/Max stay restrictions and also indicates if there check-in and check-out possible.
Time – number of the day in the time span
TimeUnit – Time unit measure, always set to “Day” now
MinMaxMessageType – Describes the type of the LOS output, “FullPatternLOS” means that your are getting daily breakdown
MinLOS – Min stay on the date
MaxLOS – Max stay on the date
NoCheckin – No check-in allowed on the date
NoCheckout – No check-out allowed on the date

API Documentation