Skip to main content

Hotel Price Check

5.0.0
Hotel
Pricing
SOAP API
Travel Agency

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.

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.

 

Target Audience
Travel Agency
API Version
5.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 it?

  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.

Request structure

Refer to the Request Design Documentation for an XML view of the request structure.

Response structure

Refer to the Response Design Documentation for an XML view of the response structure.

 

Sample Request
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <SOAP-ENV:Header>
        <eb:MessageHeader eb:version="3.0.0" xmlns:eb="http://www.ebxml.org/namespaces/messageHeader">
            <eb:From>
                <eb:PartyId>777</eb:PartyId>
            </eb:From>
            <eb:To>
                <eb:PartyId>webservices.sabre.com</eb:PartyId>
            </eb:To>
            <eb:CPAId>TM61</eb:CPAId>
            <eb:ConversationId>1234567890</eb:ConversationId>
            <eb:Action>HotelPriceCheckRQ</eb:Action>
            <eb:MessageData>
                <eb:MessageId>LbQ26Jnofb4Q8f3Pk15Mg5</eb:MessageId>
                <eb:Timestamp>2015-05-12T13:23:00Z</eb:Timestamp>
                <eb:TimeToLive>2015-05-12T13:23:00Z</eb:TimeToLive>
            </eb:MessageData>
        </eb:MessageHeader>
        <wsse:Security xmlns:wsse="http://schemas.xmlsoap.org/ws/2002/12/secext">
            <wsse:BinarySecurityToken>{{usg-session-token}}</wsse:BinarySecurityToken>
        </wsse:Security>
    </SOAP-ENV:Header>
    <SOAP-ENV:Body>
        <HotelPriceCheckRQ xmlns="http://services.sabre.com/hotel/pricecheck/v5_0_0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="5.0.0" xsi:schemaLocation="http://services.sabre.com/hotel/pricecheck/v5_0_0 HotelPriceCheckRQ_v5.0.0.xsd">
            <!-- POS tag can be used in place of calling ContextChangeLLSRQ - availability will be done assuming you've already AAAed into the PCC in the Source // @PseudoCityCode -->
            <POS>
                <Source PseudoCityCode="TM61"/>
            </POS>
            <RateInfoRef RateKey="eDS8DqooOoRTtmhh1yIFmhNGJ1cBJiVFeZs7rW0tECeKtM2PDxz9DVACIvOpYjlP+KIwFuuMXd/xsVI8SplKmTxupqcnvtscQuEb6AbKQ0vHcMotkWwoCsD/LdgeMLcgdIB9ersLdU75HexEFcC80mmy7y/6xHegfYMQfx7H3bzcFTKGUAuLIT9guvxdMrs5joa5E5DJSya05TsOBzkZShdWq8DujbbSTX4+/3FxLuzbnoxMgvVflJcavmSvicKXGHtAUEWVZH7p7V34ATzQNkPfm3KBC4ZNcJzN7D7zWwCC3CNUKEoSW8BFoq1Z9OKWgSHnVyXEmDS/N54EHYvryiWN9QMCJJzcNYLymQhNfq/YqJ6WSyA8B/T8eAwM00nWSFhMpkuvx2hpBVguxmRXNI2UHS92xKZB3YYR5qGtj0B16sYgbB9S1GjLzy5oRMXY7qOkd7VoNTg3G2fu2vXHd5wvmppIGcoJuZdJA1XIPzXiU6C3D9eDRM/6g5wJ8j8Ld44VYN/FgrjDxk6clSmyEsKZAIGr22DqR/sds9sgHDJ1jTj9n0zxPN1SnaPzugoRlOTHMFVdPI+snrLISJAhd73i60SOq1j0IawXdhj9W35B/c+PNewX8FA06mQCCao4mn3W/m6MMfQABTkAoJEw+sk+ZVAdhEwJ7T0VQGuPktg=">
            </RateInfoRef>
            <TPAExtensions>
                <auto-generated_for_wildcard/>
            </TPAExtensions>
        </HotelPriceCheckRQ>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Sample Response
<HotelPriceCheckRS>
    <PriceCheckInfo PriceDifference="0.00" CurrencyCode="USD" BookingKey="ec72f271-2a1c-4007-a8ee-6a39f41e2f1d" ConvertedPriceChange="false" PriceChange="false" ConvertedCurrencyCode="USD" ConvertedPriceDifference="0.00">
        <HotelInfo BrandName="Marriott Hotels" HotelCode="100012884" ChainName="Marriott Hotels" ChainCode="MC" CodeContext="GLOBAL" SabreRating="4.0" BrandCode="10002" SabreHotelCode="1212" HotelName="Chicago Marriott Schaumburg">
            <LocationInfo Latitude="42.029626" Longitude="-88.031848">
                <Address>
                    <AddressLine1>50 N Martingale Rd</AddressLine1>
                    <CityName CityCode="ORD">Schaumburg</CityName>
                    <StateProv StateCode="IL"/>
                    <PostalCode>60173</PostalCode>
                    <CountryName Code="US">United States of America</CountryName>
                </Address>
                <Contact Phone="1-847-2400100" Fax="1-847-2402388"/>
            </LocationInfo>
        </HotelInfo>
        <HotelRateInfo>
            <RateInfos>
                <RateInfo HighestNightlyRate="143.00" AverageNightlyRate="149.04" RateKey="eDS8DqooOoRTtmhh1yIFmrC6jRhFzTzpMIrr0aGO0zl0wyznleuAArlyq53HiUuW/PPs0DVkiPd8zHAQudNFkj0KDwjR6T8gqzF9ms2by4JgvxJa4WD/Q7Iko9ZPNjntpAH075afmYeyOR0rHPgmXzURRNbFelqCJ8uCfHzUH0ly4RkuJ5sFOoijrXqtmdSzMFwB7+AXvSVtrxnIJHnCyt6aT2JRc/jZgjO7xP+8zbvdkPoPGLOyvMSKnUJwq6ZmF9J7pNaSBSlAI/1+WZ/sw6ma2NMEjwJDHoFvLHEPS99Yyvt5ENKv6spORshRerCJWEBLuIv8BPa7ZSSTvcVC5gHrO3MuKqiLyw+AYFZo89XLC1pIDVwmIsPBNdfTzf5ovK0Oj9/g/lwSAZbESSPGDofO0ySQBdDF1L88829w7HT/8bukF7c4X9VhcLEpXvpd48+sdBB4qU0qClDhLERliIS+D0fwhyJcMZ8Y+ynW04dBDp4e80CVJd6CPLjvx/EfCxK76hvOFW/tYANIga1yiRAL5WXVl+77GSorAmtKW7hvUf/78mPUMbcTNqTCLXelQ/0cU3luhz0vpzUtebQv3gEpIMY9j5/O0oYJnuf8h6lJpvPBRdGE2d5UZtrHUbWyNCNxJQyPzTJ45ZDDxi4libu+wdplH5B1V97RUWDn/Hk=" ApproxTotalPrice="745.20" AverageNightlyRateBeforeTax="129.60" EndDate="2023-12-06" StartDate="2023-12-01" CurrencyCode="USD" AmountAfterTax="745.20" AdditionalFeesInclusive="true" AmountBeforeTax="648.00" RateSource="100" TaxInclusive="true">
                    <Commission Type="Variable">
                        <CommissionDescription>
                            <Text>COMMISSIONABLE</Text>
                        </CommissionDescription>
                    </Commission>
                </RateInfo>
                <ConvertedRateInfo HighestNightlyRate="143.00" AverageNightlyRate="149.04" RateKey="eDS8DqooOoRTtmhh1yIFmrC6jRhFzTzpMIrr0aGO0zl0wyznleuAArlyq53HiUuW/PPs0DVkiPd8zHAQudNFkj0KDwjR6T8gqzF9ms2by4JgvxJa4WD/Q7Iko9ZPNjntpAH075afmYeyOR0rHPgmXzURRNbFelqCJ8uCfHzUH0ly4RkuJ5sFOoijrXqtmdSzMFwB7+AXvSVtrxnIJHnCyt6aT2JRc/jZgjO7xP+8zbvdkPoPGLOyvMSKnUJwq6ZmF9J7pNaSBSlAI/1+WZ/sw6ma2NMEjwJDHoFvLHEPS99Yyvt5ENKv6spORshRerCJWEBLuIv8BPa7ZSSTvcVC5gHrO3MuKqiLyw+AYFZo89XLC1pIDVwmIsPBNdfTzf5ovK0Oj9/g/lwSAZbESSPGDofO0ySQBdDF1L88829w7HT/8bukF7c4X9VhcLEpXvpd48+sdBB4qU0qClDhLERliIS+D0fwhyJcMZ8Y+ynW04dBDp4e80CVJd6CPLjvx/EfCxK76hvOFW/tYANIga1yiRAL5WXVl+77GSorAmtKW7hvUf/78mPUMbcTNqTCLXelQ/0cU3luhz0vpzUtebQv3gEpIMY9j5/O0oYJnuf8h6lJpvPBRdGE2d5UZtrHUbWyNCNxJQyPzTJ45ZDDxi4libu+wdplH5B1V97RUWDn/Hk=" ApproxTotalPrice="745.20" AverageNightlyRateBeforeTax="129.60" EndDate="2023-12-06" StartDate="2023-12-01" CurrencyCode="USD" AmountAfterTax="745.20" AdditionalFeesInclusive="true" AmountBeforeTax="648.00" RateSource="100" TaxInclusive="true">
                    <Commission Type="Variable">
                        <CommissionDescription>
                            <Text>COMMISSIONABLE</Text>
                        </CommissionDescription>
                    </Commission>
                </ConvertedRateInfo>
            </RateInfos>
            <Rooms>
                <Room RoomType="Guest Room" RoomTypeCode="42" RoomIndex="1">
                    <BedTypeOptions>
                        <BedTypes>
                            <BedType Description="Queen Bed" Count="2" Code="5"/>
                        </BedTypes>
                    </BedTypeOptions>
                    <RoomDescription Name="AAA HOT DEALS">
                        <Text>AAA CAA HOT DEALS, HOT BUFFET BREAKFAST FOR 2 GUESTS DAILY, GUEST ROOM, 2 QUEEN-S- MAX OCCUPANCY- 4 GUESTS 2 QUEEN BEDS, 2 QUEEN-S-, MINI FRIDGE, 312SQFT/28SQM, WIRELESS INTERNET, FOR A FEE, 32IN/81CM FLATSCREEN TV AAA RATE INCLUDES - 20 PERCENT OFF RETAIL RATE - FREE WIRELESS INTERNET IN ALL ROOMS - FREE PARKING</Text>
                    </RoomDescription>
                    <Amenities>
                        <Amenity Description="Mini-refrigerator" Code="164"/>
                        <Amenity Description="Color television" Code="20"/>
                        <Amenity Description="TV" Code="251"/>
                    </Amenities>
                    <RatePlans>
                        <RatePlan RatePlanType="13" ProductCode="AABT00" RatePlanName="AAA HOT DEALS" RateKey="eDS8DqooOoRTtmhh1yIFmrC6jRhFzTzpMIrr0aGO0zl0wyznleuAArlyq53HiUuW/PPs0DVkiPd8zHAQudNFkj0KDwjR6T8gqzF9ms2by4JgvxJa4WD/Q7Iko9ZPNjntpAH075afmYeyOR0rHPgmXzURRNbFelqCJ8uCfHzUH0ly4RkuJ5sFOoijrXqtmdSzMFwB7+AXvSVtrxnIJHnCyt6aT2JRc/jZgjO7xP+8zbvdkPoPGLOyvMSKnUJwq6ZmF9J7pNaSBSlAI/1+WZ/sw6ma2NMEjwJDHoFvLHEPS99Yyvt5ENKv6spORshRerCJWEBLuIv8BPa7ZSSTvcVC5gHrO3MuKqiLyw+AYFZo89XLC1pIDVwmIsPBNdfTzf5ovK0Oj9/g/lwSAZbESSPGDofO0ySQBdDF1L88829w7HT/8bukF7c4X9VhcLEpXvpd48+sdBB4qU0qClDhLERliIS+D0fwhyJcMZ8Y+ynW04dBDp4e80CVJd6CPLjvx/EfCxK76hvOFW/tYANIga1yiRAL5WXVl+77GSorAmtKW7hvUf/78mPUMbcTNqTCLXelQ/0cU3luhz0vpzUtebQv3gEpIMY9j5/O0oYJnuf8h6lJpvPBRdGE2d5UZtrHUbWyNCNxJQyPzTJ45ZDDxi4libu+wdplH5B1V97RUWDn/Hk=" RateSource="100" PrepaidIndicator="false" LimitedAvailability="false" RatePlanCode="Z2H">
                            <RatePlanInclusions>
                                <RatePlanInclusion Description="Internet services" Code="223"/>
                                <RatePlanInclusion Description="Free High Speed Internet Connection" Code="222"/>
                                <RatePlanInclusion Description="Free Parking" Code="42"/>
                            </RatePlanInclusions>
                            <MealsIncluded MealPlanDescription="Breakfast" Breakfast="true" Dinner="false" MealPlanCode="19" MealPlanIndicator="true" Lunch="false"/>
                            <RateInfo StartDate="2023-12-01" CurrencyCode="USD" AmountAfterTax="745.20" AdditionalFeesInclusive="true" AmountBeforeTax="648.00" AverageNightlyRate="149.04" AverageNightlyRateBeforeTax="129.60" EndDate="2023-12-06" TaxInclusive="true">
                                <Rates>
                                    <Rate StartDate="2023-12-01" CurrencyCode="USD" AmountBeforeTax="132.00" EndDate="2023-12-03"/>
                                    <Rate StartDate="2023-12-03" CurrencyCode="USD" AmountBeforeTax="102.00" EndDate="2023-12-04"/>
                                    <Rate StartDate="2023-12-04" CurrencyCode="USD" AmountBeforeTax="139.00" EndDate="2023-12-05"/>
                                    <Rate StartDate="2023-12-05" CurrencyCode="USD" AmountBeforeTax="143.00" EndDate="2023-12-06"/>
                                </Rates>
                                <Taxes CurrencyCode="USD" Amount="97.20">
                                    <Tax StartDate="2023-12-01" CurrencyCode="USD" Amount="19.80" EndDate="2023-12-03"/>
                                    <Tax StartDate="2023-12-05" CurrencyCode="USD" Amount="20.85" EndDate="2023-12-06"/>
                                    <TaxGroups>
                                        <TaxGroup CurrencyCode="USD" Description="City / Municipal Tax" Amount="51.84" Code="3">
                                            <TaxDescription>
                                                <Text>CITY / MUNICIPAL TAX</Text>
                                            </TaxDescription>
                                        </TaxGroup>
                                        <TaxGroup CurrencyCode="USD" Description="State / Province Tax" Amount="38.88" Code="15">
                                            <TaxDescription>
                                                <Text>STATE / PROVINCE TAX</Text>
                                            </TaxDescription>
                                        </TaxGroup>
                                        <TaxGroup CurrencyCode="USD" Description="County tax" Amount="6.48" Code="4">
                                            <TaxDescription>
                                                <Text>COUNTY TAX</Text>
                                            </TaxDescription>
                                        </TaxGroup>
                                    </TaxGroups>
                                </Taxes>
                                <RoomExtras>
                                    <RoomExtra CurrencyCode="USD" Description="Extra adult charge" Amount="0.00" Code="196"/>
                                    <RoomExtra CurrencyCode="USD" Description="Rollaway bed" Amount="0.00" Code="91"/>
                                    <RoomExtra CurrencyCode="USD" Description="Cribs" Amount="0.00" Code="26"/>
                                </RoomExtras>
                                <CancelPenalties>
                                    <CancelPenalty Refundable="true">
                                        <Deadline AbsoluteDeadline="2023-12-01T18:00:00"/>
                                    </CancelPenalty>
                                </CancelPenalties>
                                <Guarantee GuaranteeType="GUAR">
                                    <GuaranteesAccepted>
                                        <GuaranteeAccepted GuaranteeTypeCode="5" GuaranteeTypeDescription="Credit card">
                                            <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="JC">JCB CREDIT CARD</PaymentCard>
                                                <PaymentCard CardCode="VI">VISA</PaymentCard>
                                                <PaymentCard CardCode="VS">VISA</PaymentCard>
                                                <PaymentCard CardCode="MC">MASTER CARD</PaymentCard>
                                            </PaymentCards>
                                        </GuaranteeAccepted>
                                    </GuaranteesAccepted>
                                </Guarantee>
                                <AdditionalDetails>
                                    <AdditionalDetail Description="Rate disclaimer information" Code="32">
                                        <Text>INCLUDES TAXES AND SURCHARGES</Text>
                                    </AdditionalDetail>
                                    <AdditionalDetail Description="Cancellation information" Code="7">
                                        <Text>CANCEL PERMITTED UP TO  6 PM  DAY OF ARRIVAL</Text>
                                        <Text>151.80 USD CANCEL FEE PER ROOM</Text>
                                    </AdditionalDetail>
                                    <AdditionalDetail Description="Miscellaneous information" Code="14">
                                        <Text>COMMITMENT-HTTPS//CLEAN*MARRIOTT*COM</Text>
                                    </AdditionalDetail>
                                </AdditionalDetails>
                            </RateInfo>
                            <ConvertedRateInfo StartDate="2023-12-01" CurrencyCode="USD" AmountAfterTax="745.20" AdditionalFeesInclusive="true" AmountBeforeTax="648.00" AverageNightlyRate="149.04" AverageNightlyRateBeforeTax="129.60" EndDate="2023-12-06" TaxInclusive="true">
                                <Rates>
                                    <Rate StartDate="2023-12-01" CurrencyCode="USD" AmountBeforeTax="132.00" EndDate="2023-12-03"/>
                                    <Rate StartDate="2023-12-03" CurrencyCode="USD" AmountBeforeTax="102.00" EndDate="2023-12-04"/>
                                    <Rate StartDate="2023-12-04" CurrencyCode="USD" AmountBeforeTax="139.00" EndDate="2023-12-05"/>
                                    <Rate StartDate="2023-12-05" CurrencyCode="USD" AmountBeforeTax="143.00" EndDate="2023-12-06"/>
                                </Rates>
                                <Taxes CurrencyCode="USD" Amount="97.20">
                                    <Tax StartDate="2023-12-01" CurrencyCode="USD" Amount="19.80" EndDate="2023-12-03"/>
                                    <Tax StartDate="2023-12-05" CurrencyCode="USD" Amount="20.85" EndDate="2023-12-06"/>
                                    <TaxGroups>
                                        <TaxGroup CurrencyCode="USD" Description="City / Municipal Tax" Amount="51.84" Code="3">
                                            <TaxDescription>
                                                <Text>CITY / MUNICIPAL TAX</Text>
                                            </TaxDescription>
                                        </TaxGroup>
                                        <TaxGroup CurrencyCode="USD" Description="State / Province Tax" Amount="38.88" Code="15">
                                            <TaxDescription>
                                                <Text>STATE / PROVINCE TAX</Text>
                                            </TaxDescription>
                                        </TaxGroup>
                                        <TaxGroup CurrencyCode="USD" Description="County tax" Amount="6.48" Code="4">
                                            <TaxDescription>
                                                <Text>COUNTY TAX</Text>
                                            </TaxDescription>
                                        </TaxGroup>
                                    </TaxGroups>
                                </Taxes>
                                <RoomExtras>
                                    <RoomExtra CurrencyCode="USD" Description="Extra adult charge" Amount="0.00" Code="196"/>
                                    <RoomExtra CurrencyCode="USD" Description="Rollaway bed" Amount="0.00" Code="91"/>
                                    <RoomExtra CurrencyCode="USD" Description="Cribs" Amount="0.00" Code="26"/>
                                </RoomExtras>
                                <CancelPenalties>
                                    <CancelPenalty Refundable="true">
                                        <Deadline AbsoluteDeadline="2023-12-01T18:00:00"/>
                                    </CancelPenalty>
                                </CancelPenalties>
                                <Guarantee GuaranteeType="GUAR">
                                    <GuaranteesAccepted>
                                        <GuaranteeAccepted GuaranteeTypeCode="5" GuaranteeTypeDescription="Credit card">
                                            <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="JC">JCB CREDIT CARD</PaymentCard>
                                                <PaymentCard CardCode="VI">VISA</PaymentCard>
                                                <PaymentCard CardCode="VS">VISA</PaymentCard>
                                                <PaymentCard CardCode="MC">MASTER CARD</PaymentCard>
                                            </PaymentCards>
                                        </GuaranteeAccepted>
                                    </GuaranteesAccepted>
                                </Guarantee>
                                <AdditionalDetails>
                                    <AdditionalDetail Description="Rate disclaimer information" Code="32">
                                        <Text>INCLUDES TAXES AND SURCHARGES</Text>
                                    </AdditionalDetail>
                                    <AdditionalDetail Description="Cancellation information" Code="7">
                                        <Text>CANCEL PERMITTED UP TO  6 PM  DAY OF ARRIVAL</Text>
                                        <Text>151.80 USD CANCEL FEE PER ROOM</Text>
                                    </AdditionalDetail>
                                    <AdditionalDetail Description="Miscellaneous information" Code="14">
                                        <Text>COMMITMENT-HTTPS//CLEAN*MARRIOTT*COM</Text>
                                    </AdditionalDetail>
                                </AdditionalDetails>
                            </ConvertedRateInfo>
                        </RatePlan>
                    </RatePlans>
                </Room>
            </Rooms>
        </HotelRateInfo>
    </PriceCheckInfo>
</HotelPriceCheckRS>