Skip to main content

Hotel Price Check

3.0.0
Hotel
Pricing
SOAP API
Travel Agency

Hotel Price Check API is a step between Shopping and Booking that ensures the price returned in shopping for a chosen product is still applicable just prior to booking.

 

Not Signed In.

Looks like you may not have access to all of the resources and documentation for this page.
Please log-in or contact your support desk team if you believe you should have access.

Target Audience
Travel Agency
API Version
3.0.0
Authentication
Session or Sessionless Tokens
Service Action Code
HotelPriceCheckRQ

What is it?

Use this API to verify whether the rate you are seeing is the latest rate sent by our supply source, without having to maintain information at the user’s end. This API is a mandatory step before you can proceed to booking a product.

  • The API accepts only a single input parameter, a rateKey unique to Sabre. This Rate Key is returned in the Get Hotel Availability and/or the Get Hotel Details response.
  • This rateKey is decrypted to find the original availability request with all original parameters, and sent to the correct supply source to fetch the latest rates for the chosen product.
  • The latest rate is compared against the earlier shown rate, and the user is given an accurate value of how much the rate has increased or decrease
  • The Rate Key returned in Shopping responses does not expire so can be used in the HotelPriceCheck request at any time. The rate itself may have expired, but this will be reflected in the HotelPriceCheck response.

How to use

  1. Create an availability request for a hotel using either the Get Hotel Availability API or Get Hotel Details API, and select a product to request HotelPriceCheck for.
  2. From the availability response, take the encrypted rateKey and pass it to the Hotel Price Check request in the payload.

Click here for more details about the API request or click here for more details about the API response.

Request Structure

Refer to the design document for the full schema.

The Hotel Price Check request contains the following attributes:

Element Attribute Description
RateInfoRef   A request message for information and details about the available rates of the property.
  RateKey A Sabre generated rate key that should be picked from a shopping API and passed here.

 

Response Structure

The Hotel Price Check response contains the following attributes:

Name Description
PriceCheckInfo Describes the latest information for the chosen product along with any observed changes in rates.
HotelRateInfo Returns rate-specific information for a hotel.
BookingKey A uniquely generated key needed to make a hotel reservation.
PriceChange If true, the price has changed in the supplier's returned currency.
PriceDifference

Returns the amount by which the rate was increased or decreased in the supplier's returned currency.

CurrencyCode Returns the supplier's returned IATA (ISO 4217) currency code. 
ConvertedPriceChange If true, the price has changed in the user's requested currency.
ConvertedPriceDifference Returns the amount by which the rate was increased or decreased in the user's requested currency.
ConvertedCurrencyCode Returns the user's requested IATA (ISO 417) currency code.
RateInfos A collection of information about rates for a request from all suppliers.
Rooms Describes the information of a hotel room for a property.

 

Sample Request
<HotelPriceCheckRQ xmlns="http://services.sabre.com/hotel/pricecheck/v3_0_0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="3.0.0" xsi:schemaLocation="http://services.sabre.com/hotel/pricecheck/v3_0_0 HotelPriceCheckRQ_v3.0.0.xsd">
	<POS>
		<Source PseudoCityCode="TM51"/>
	</POS>
	<RateInfoRef RateKey="M7a/GF4b8GZKek+oaLQHZPpJMZH9+EAr5vpWDV6RalwAnP8LZtuaRe+ZQUscsEulk3yWECBJhshL9dL7zfDrbY/267Zto5yPff1icaL4e4JvvQoGA7Y4o6v0/RktuBZWIT9Smgm/17ZLvdWdG4o2BQGFIK5L6qQy+lEU30fQr/TKhd5okrfWzVgqiGSthXqA3JESIuPMT2gFr/XM7INx4JVd7UE9VRKFaFiCnWlnaxVphk5vFCAEete77afEF01v4sdAXIOcMhFY0BhBfmh1ckYcflor8BEZsg93H2rBOrzZQHNk1H1M5oeCG66JnVhsEZ5iZxbSYVfWf4hjDTgEix5HqnwexLoFd5IAYwGlYpAFYWKEpKUFBT6c9EAQv8FFvetdBnXwmnmxVTzLiX8IzPwcNGuDsy+okEH/5qGxp9bo9QiWs/WpPZrGgIcvHibT"/>
</HotelPriceCheckRQ>
Sample Response
<HotelPriceCheckRS>
  <PriceCheckInfo PriceDifference="0.0" CurrencyCode="USD" BookingKey="70c427b5-9ab0-4e4d-b75f-22f84238b673" PriceChange="false">
    <HotelInfo BrandName="undefined" HotelCode="100070928" ChainName="Westin Hotels And Resorts" ChainCode="WI" CodeContext="GLOBAL" SabreRating="4.0" BrandCode="10000" SabreHotelCode="4513" HotelName="Westin Dfw Airport">
      <LocationInfo Latitude="32.916499" Longitude="-97.008257">
        <Address>
          <AddressLine1>4545 W John Carpenter Freeway</AddressLine1>
          <CityName CityCode="DFW">Irving</CityName>
          <StateProv StateCode="TX"/>
          <PostalCode>75063</PostalCode>
          <CountryName Code="US">United States (the)</CountryName>
        </Address>
        <Contact Phone="1-972-929-4500" Fax="1-972-929-0733"/>
      </LocationInfo>
    </HotelInfo>
    <HotelRateInfo>
      <RateInfos>
        <RateInfo StartDate="2019-10-20" CurrencyCode="USD" AmountAfterTax="783.30" AdditionalFeesInclusive="true" AmountBeforeTax="681.15" AverageNightlyRate="261.10" RateKey="M7a/GF4b8GZKek+oaLQHZEj8m5NCT91VKGhOZNUa01IIZuivuS0eP8avBEG4Wu+Uy4/yj3BORlpxSGm/S9arI7Gu9/B7O1QKtp7vdKcE7uWUbQNn3QOyQ4NGF4bPVKL+0dBaPfg52e+umkcwrRuvabdhhS6qnczZFAlLD5bRcdtj97YhYIHQ7+eEQS2zcwcW60WZyuL7dBO/Wsi9AEeFrQAj7JPZIFJnMlv4qaFvmuhg6UMDLfhKfZp5vUx7oJzbTDyQ7AvonHPAMgxQ1XkGgS9+h3xWOFwybx7QTM7noNJmpMY3vcXTZbilUkIHg6CLeFgLBm6plCk5EmOXYSqMzt7jXgMwiR8kTa7mc6HQH1ycrekH4mOJTlR9W4lm2rhVXG9V4ta4bBztAmH//edkIkd5wvuuLcVSXX7W55b8jAMRzReFTM6jTIaqe04A3FMq" RateSource="100" EndDate="2019-10-23" TaxInclusive="true">
          <Commission Type="Variable">
            <CommissionDescription>
              <Text>COMMISSIONABLE</Text>
            </CommissionDescription>
          </Commission>
        </RateInfo>
      </RateInfos>
      <Rooms>
        <Room RoomIndex="1">
          <BedTypes>
            <BedType Code="3"/>
          </BedTypes>
          <RoomDescription Name="AAA AMERICAN AUTO ASSN">
            <Text>AAA RATE, AAA MEMBERSHIP CARD REQUIRED, GUEST ROOM, 1 KING MAX OCCUPANCY- 4 GUESTS KING GUEST ROOM, 1 KING, COFFEE/TEA MAKER, TV AMERICAN AUTO ASSOCIATION RATE -  AVAILABLE TO AAA MEMBERS ONLY. -  LIMIT OF TWO ROOMS PER AAA MEMBER PER NIGHT. -  AAA MEMBERSHIP CARD REQUIRED AT CHECK-IN.</Text>
          </RoomDescription>
          <AdditionalDetails>
            <AdditionalDetail Code="32">
              <Text>INCLUDES TAXES AND SURCHARGES</Text>
            </AdditionalDetail>
            <AdditionalDetail Code="7">
              <Text>CANCEL PERMITTED UP TO 02 DAYS BEFORE ARRIVAL 195.55 USD CANCEL FEE PER ROOM</Text>
            </AdditionalDetail>
            <AdditionalDetail Code="14">
              <Text>WESTIN HOTELS - LETS RISE</Text>
            </AdditionalDetail>
          </AdditionalDetails>
          <RatePlans>
            <RatePlan RatePlanType="24" ProductCode="QAAD00" RatePlanName="AAA AMERICAN AUTO ASSN" RateKey="M7a/GF4b8GZKek+oaLQHZEj8m5NCT91VKGhOZNUa01IIZuivuS0eP8avBEG4Wu+Uy4/yj3BORlpxSGm/S9arI7Gu9/B7O1QKtp7vdKcE7uWUbQNn3QOyQ4NGF4bPVKL+0dBaPfg52e+umkcwrRuvabdhhS6qnczZFAlLD5bRcdtj97YhYIHQ7+eEQS2zcwcW60WZyuL7dBO/Wsi9AEeFrQAj7JPZIFJnMlv4qaFvmuhg6UMDLfhKfZp5vUx7oJzbTDyQ7AvonHPAMgxQ1XkGgS9+h3xWOFwybx7QTM7noNJmpMY3vcXTZbilUkIHg6CLeFgLBm6plCk5EmOXYSqMzt7jXgMwiR8kTa7mc6HQH1ycrekH4mOJTlR9W4lm2rhVXG9V4ta4bBztAmH//edkIkd5wvuuLcVSXX7W55b8jAMRzReFTM6jTIaqe04A3FMq" RateSource="100" PrepaidIndicator="false" LimitedAvailability="false">
              <RateInfo StartDate="2019-10-20" CurrencyCode="USD" AmountAfterTax="783.30" AdditionalFeesInclusive="true" AmountBeforeTax="681.15" AverageNightlyRate="261.10" EndDate="2019-10-23" TaxInclusive="true">
                <Rates>
                  <Rate StartDate="2019-10-20" CurrencyCode="USD" AmountBeforeTax="170.05" EndDate="2019-10-21"/>
                  <Rate StartDate="2019-10-21" CurrencyCode="USD" AmountBeforeTax="246.05" EndDate="2019-10-22"/>
                  <Rate StartDate="2019-10-22" CurrencyCode="USD" AmountBeforeTax="265.05" EndDate="2019-10-23"/>
                </Rates>
                <Taxes CurrencyCode="USD" Amount="102.15">
                  <Tax StartDate="2019-10-20" CurrencyCode="USD" Amount="25.51" EndDate="2019-10-21"/>
                  <Tax StartDate="2019-10-21" CurrencyCode="USD" Amount="36.91" EndDate="2019-10-22"/>
                  <Tax StartDate="2019-10-22" CurrencyCode="USD" Amount="39.76" EndDate="2019-10-23"/>
                  <TaxGroups>
                    <TaxGroup CurrencyCode="USD" Amount="61.30" Code="3">
                      <TaxDescription>
                        <Text>CITY TAX</Text>
                      </TaxDescription>
                    </TaxGroup>
                    <TaxGroup CurrencyCode="USD" Amount="40.87" Code="15">
                      <TaxDescription>
                        <Text>STATE / PROVINCE TAX</Text>
                      </TaxDescription>
                    </TaxGroup>
                  </TaxGroups>
                </Taxes>
                <RoomExtras>
                  <RoomExtra CurrencyCode="USD" Amount="10.00" Code="196">
                    <Text>Extra adult charge</Text>
                  </RoomExtra>
                  <RoomExtra CurrencyCode="USD" Amount="0.00" Code="26">
                    <Text>Cribs</Text>
                  </RoomExtra>
                  <RoomExtra CurrencyCode="USD" Amount="10.00" Code="91">
                    <Text>Rollaway bed</Text>
                  </RoomExtra>
                </RoomExtras>
                <CancelPenalties>
                  <CancelPenalty Refundable="true">
                    <Deadline OffsetTimeUnit="Day" OffsetUnitMultiplier="2"/>
                  </CancelPenalty>
                </CancelPenalties>
                <Guarantee GuaranteeType="GUAR">
                  <GuaranteesAccepted>
                    <GuaranteeAccepted GuaranteeTypeCode="5">
                      <PaymentCards>
                        <PaymentCard CardCode="AX">AMERICAN EXPRESS</PaymentCard>
                        <PaymentCard CardCode="CA">MASTERCARD</PaymentCard>
                        <PaymentCard CardCode="DC">DINERS CLUB CARD</PaymentCard>
                        <PaymentCard CardCode="DS">DISCOVER CARD</PaymentCard>
                        <PaymentCard CardCode="IK">MASTER CARD</PaymentCard>
                        <PaymentCard CardCode="VI">VISA</PaymentCard>
                      </PaymentCards>
                    </GuaranteeAccepted>
                    <GuaranteeAccepted GuaranteeTypeCode="19"/>
                  </GuaranteesAccepted>
                </Guarantee>
              </RateInfo>
            </RatePlan>
          </RatePlans>
        </Room>
      </Rooms>
    </HotelRateInfo>
  </PriceCheckInfo>