Skip Navigation

Get Hotel Rate Info

5.0.0
Hotel
Search
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.

The Get Hotel Rate Info (GetHotelRateInfoRQ) API is used to retrieve all possible available rates for a specified property from multiple supply sources, including the GDS and aggregators, based on stay criteria.

Target Audience
Travel Agency
API Version
5.0.0
Authentication
Session or Sessionless Tokens
Service Action Code
GetHotelRateInfoRQ

What is it?

The Get Hotel Rate Info API is used to retrieve all available rates for a specified property from multiple supply sources including the GDS and aggregators based on stay criteria.

Why use it?

The Rate Info API offers all available rate information for a selected property. If one of the rates is of further interest, you can call Hotel Price Check API and complete the booking with the help of a RateKey.

How does it work?

The Get Hotel Rate Info API makes a live call to requested suppliers for detailed rate information on all products that match with the customer’s search criteria. The API returns a RateKey for each product to allow the customer to proceed with the booking.  

How do I use it?

Filter the search criteria from the following options:  

  • PropertyID
  • CodeContext ( Global)  
  • Occupancy and Rooms  
  • Stay Dates
  • Prepaid Qualifier
  • Currency
  • Rate Range
  • Rate Plan Type, Negotiated Rates, Corporate Rates, Publicly Available Rates
  • Loyalty IDs, Corporate Discount Code, Frequent Flyer ID
  • Supply Sources  

The Get Hotel Rate Info API returns products from all sources requested with the detailed information on Rates, Taxes, Fees, Room Type, Cancel Penalty, Guarantee Information, and Commission Information. It also returns a RateKey for each product that you can use to proceed with booking.

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:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Header>
        <eb:MessageHeader eb:version="4.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>GetHotelRateInfoRQ</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:Header>
    <soap:Body>
        <GetHotelRateInfoRQ xmlns="http://services.sabre.com/hotel/rate/v5_0_0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="5.0.0" xsi:schemaLocation="http://services.sabre.com/hotel/rate/v5_0_0 GetHotelRateInfoRQ_V5.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>
            <HotelRefs>
                <HotelRef HotelCode="100019414" CodeContext="GLOBAL"/>
            </HotelRefs>
            <RateInfoRef CurrencyCode="USD" PrepaidQualifier="IncludePrepaid" RefundableOnly="true" ConvertedRateInfoOnly="true" TravellerCountry="US">
                <StayDateTimeRange StartDate="2023-12-01" EndDate="2023-12-06"/>
                <RateFilters>
                    <RateFilter Type="RateCode" Value="S9R" Action="Exclude"/>
                    <RateFilter Type="RateType" Value="13" Action="Exclude"/>
                    <RateFilter Type="Commission" Value="NC" Action="Exclude"/>
                    <RateFilter Type="BedType" Value="3" Action="Include"/>
                    <RateFilter Type="RoomView" Value="9" Action="Include"/>
                    <RateFilter Type="Meals" Value="19" Action="Include"/>
                    <RateFilter Type="RoomType" Value="42" Action="Include"/>
                </RateFilters>
                <Rooms>
                    <Room Index="1" Adults="1" Children="2">
                        <ChildAges>1,2</ChildAges>
                    </Room>
                </Rooms>
                <RatePlanCandidates ExactMatchOnly="false">
                    <RatePlanCandidate RatePlanCode="IBM"/>
                    <RatePlanCandidate RatePlanType="8"/>
                    <RatePlanCandidate RatePlanType="9"/>
                </RatePlanCandidates>
            </RateInfoRef>
            <TPAExtensions>
                <auto-generated_for_wildcard/>
            </TPAExtensions>
        </GetHotelRateInfoRQ>
    </soap:Body>
</soap:Envelope>
Sample Response
<GetHotelRateInfoRS>
    <HotelRateInfos>
        <HotelRateInfo>
            <HotelInfo HotelCode="100019414" ChainCode="MC" CodeContext="GLOBAL" SabreHotelCode="1212"/>
            <RateInfos>
                <ConvertedRateInfo HighestNightlyRate="169.00" AverageNightlyRate="169.05" RateKey="TEoOax6vXqdEBWFNXxfSqLDhjK70kg/gWcR09XWBzmHfaulnX6Dzq/hk+WeI1W4ixYEbuMjqCl+co6LXRbGY0J8uQZy4fxWKoJozJuUWQ3Qmu/clhPApI/h/SF3hNF172Q7shfBXqxyUkOE4Zyqn8h4FKqp4AofVtCQBQ/LAtUdqtcXLt6+MN0WenRoWAd+VF1xJjWagCO47ry1PeJGjcTAZoUZRhWrKKXkiRkb4thWOKiMNmaAdy2LtaB0qY655oxMcfcpLpzHPmZ1o1HMoRj70wS4B8xOknihYjfFoE/ylKTDhD6Isbkaoj+eiUrQ9UyKjPgxmS1SjxDHEF29A3lIdhRHZ0ww5gVCO9/mma2MTU13hnY9ul12KpoUuguMbPUOaN8kYMRJMzJdh4DLOz2jdyR5O+vuIlXT0MLdMDJdAgpBdTZV2i66rYslwIU6ABXC6Ha7ynnuWTna7lPqnnUMtQWTb2BhVrLeSv2q7vCCOKMQ2Tt/zsDJr+LJFG5XYWa3DiCeRXIKXSjy8tFzYU/DI/sCMPG3C1wFQUPpv6Vyjov5yqBd2Rkfx6chz4dc/0euwCKLDL8FnpljCYlF3K8Q5ajo9+1tGKgu6QWojHEr7Qs6vjcJLweCGsH9dQVSCBkp4XTBvVuLzg6K/zbdGTpLvBpebor3X+ToDO9XUCtA8o4F7peLw+UR4+dgVTDnh9v/cLHtT0Mgq0CAWCGqLCurypq7EvhgvaPW1nKpL/vTRDO75W5QZ0p7t+pquWky75iaZU+6LyKrvQ0vjrID67JGtztimorMAGOv+MduBKPCtCzUkJ5Q0xoaCY8dn/i2/" ApproxTotalPrice="845.25" AverageNightlyRateBeforeTax="147.00" EndDate="2023-12-06" StartDate="2023-12-01" CurrencyCode="USD" AmountAfterTax="845.25" AdditionalFeesInclusive="true" AmountBeforeTax="735.00" RateSource="100" TaxInclusive="true">
                    <Commission Type="Variable">
                        <CommissionDescription>
                            <Text>COMMISSIONABLE</Text>
                        </CommissionDescription>
                    </Commission>
                </ConvertedRateInfo>
                <ConvertedRateInfo HighestNightlyRate="177.00" AverageNightlyRate="178.25" RateKey="qzVpRuSVzCazmXNRPs3s7DCdLXRAC8+z4otKmbRQ9qtTDp5GWX01iO4PLA5pBk8oFHdRPPIMtV9EpyqYk9XJ17xcldOJxLL4Grh52j4vbMyz3KX78/waLj4RHx3TUr4SI/24UBtWHBYeFmJvFgljUao04zmOqdVVCz0pVbMHjoeit0geHEY44pQJp+Gmm3Jh1fDLigNqUfbnRqNqlJtiD00s2yV6nVKTO5VwagDUH1uri506sycabS9nGLpi9aBIYMbxDWxR2GBRLyjHl0tQIbsdfQIYYTLl1Qr0eS4uyW0dqAshKG3Pes6Hd9QYa5m5kGuVVENbnEmFrxxbACT3kNES4vrnW4EK4xhL5llF3H3ohuvPTPx9HzJM+9FYso4LY9/Oud3hvXY8QlEdG7ZIzWoTWYNQqSMxwlIAaKfgd+dkfTHcStJB9+J02/C6E4/9sO61qLGIg6m3D/L7sZkwDce5ubFjjsFawgJ9L/Xi+3wLcB3qqQrCsxgPXXqGIAz7Wq2B7wT6/HnR2YyfKvkPb3lLDaLfN9TKm+0WcB3gkTpbR/N1ZKhBdXzDSx8u/q7XkzZ+/Utu1fa3iYC4BbM8L46eM3OMIEVw8P+WnpDlc89k5SJH/7LO2YvS/DKXc+LbnbdPhYNMYrLbai4+jTlytKn3DuhnMo0PPOCxdmhL5HEbBON05yGT9Q+4KH9eK30ST5lbMps+L/2pSvLYJ0BAIXJ9YPyIQGDGQpcvC9xrxISNaA0MK8gvh/rV7GsOPJkVtxCi2pD5rItZwC006lAqov7CUw6BZz0/kzyBkVid3BXD8XfypZPxO5nceKP3Hug5" ApproxTotalPrice="891.25" AverageNightlyRateBeforeTax="155.00" EndDate="2023-12-06" StartDate="2023-12-01" CurrencyCode="USD" AmountAfterTax="891.25" AdditionalFeesInclusive="true" AmountBeforeTax="775.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="King" Count="1" Code="3"/>
                        </BedTypes>
                    </BedTypeOptions>
                    <RoomDescription Name="REGULAR RATE">
                        <Text>FLEXIBLE RATE, GUEST ROOM, 1 KING</Text>
                    </RoomDescription>
                    <RatePlans>
                        <RatePlan RatePlanType="24" ProductCode="REGA00" RatePlanName="REGULAR RATE" RateKey="TEoOax6vXqdEBWFNXxfSqLDhjK70kg/gWcR09XWBzmHfaulnX6Dzq/hk+WeI1W4ixYEbuMjqCl+co6LXRbGY0J8uQZy4fxWKoJozJuUWQ3Qmu/clhPApI/h/SF3hNF172Q7shfBXqxyUkOE4Zyqn8h4FKqp4AofVtCQBQ/LAtUdqtcXLt6+MN0WenRoWAd+VF1xJjWagCO47ry1PeJGjcTAZoUZRhWrKKXkiRkb4thWOKiMNmaAdy2LtaB0qY655oxMcfcpLpzHPmZ1o1HMoRj70wS4B8xOknihYjfFoE/ylKTDhD6Isbkaoj+eiUrQ9UyKjPgxmS1SjxDHEF29A3lIdhRHZ0ww5gVCO9/mma2MTU13hnY9ul12KpoUuguMbPUOaN8kYMRJMzJdh4DLOz2jdyR5O+vuIlXT0MLdMDJdAgpBdTZV2i66rYslwIU6ABXC6Ha7ynnuWTna7lPqnnUMtQWTb2BhVrLeSv2q7vCCOKMQ2Tt/zsDJr+LJFG5XYWa3DiCeRXIKXSjy8tFzYU/DI/sCMPG3C1wFQUPpv6Vyjov5yqBd2Rkfx6chz4dc/0euwCKLDL8FnpljCYlF3K8Q5ajo9+1tGKgu6QWojHEr7Qs6vjcJLweCGsH9dQVSCBkp4XTBvVuLzg6K/zbdGTpLvBpebor3X+ToDO9XUCtA8o4F7peLw+UR4+dgVTDnh9v/cLHtT0Mgq0CAWCGqLCurypq7EvhgvaPW1nKpL/vTRDO75W5QZ0p7t+pquWky75iaZU+6LyKrvQ0vjrID67JGtztimorMAGOv+MduBKPCtCzUkJ5Q0xoaCY8dn/i2/" RateSource="100" PrepaidIndicator="false" LimitedAvailability="false">
                            <ConvertedRateInfo StartDate="2023-12-01" HighestNightlyRate="169.00" CurrencyCode="USD" AmountAfterTax="845.25" AdditionalFeesInclusive="true" AmountBeforeTax="735.00" AverageNightlyRate="169.05" ApproxTotalPrice="845.25" AverageNightlyRateBeforeTax="147.00" EndDate="2023-12-06" TaxInclusive="true">
                                <Rates>
                                    <Rate StartDate="2023-12-01" CurrencyCode="USD" AmountBeforeTax="129.00" EndDate="2023-12-02"/>
                                    <Rate StartDate="2023-12-02" CurrencyCode="USD" AmountBeforeTax="139.00" EndDate="2023-12-03"/>
                                    <Rate StartDate="2023-12-03" CurrencyCode="USD" AmountBeforeTax="144.00" EndDate="2023-12-04"/>
                                    <Rate StartDate="2023-12-04" CurrencyCode="USD" AmountBeforeTax="154.00" EndDate="2023-12-05"/>
                                    <Rate StartDate="2023-12-05" CurrencyCode="USD" AmountBeforeTax="169.00" EndDate="2023-12-06"/>
                                </Rates>
                                <Taxes CurrencyCode="USD" Amount="110.25">
                                    <Tax StartDate="2023-12-01" CurrencyCode="USD" Amount="19.35" EndDate="2023-12-02"/>
                                    <Tax StartDate="2023-12-04" CurrencyCode="USD" Amount="21.60" EndDate="2023-12-05"/>
                                </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 OffsetDropTime="BeforeArrival" OffsetTimeUnit="Day" OffsetUnitMultiplier="1"/>
                                    </CancelPenalty>
                                </CancelPenalties>
                                <Guarantee GuaranteeType="GUAR">
                                    <GuaranteesAccepted>
                                        <GuaranteeAccepted GuaranteeTypeCode="5" GuaranteeTypeDescription="Credit card">
                                            <PaymentCards>
                                                <PaymentCard CardCode="IK">MASTER CARD</PaymentCard>
                                                <PaymentCard CardCode="AX">AMERICAN EXPRESS</PaymentCard>
                                                <PaymentCard CardCode="DC">DINERS CLUB CARD</PaymentCard>
                                                <PaymentCard CardCode="DS">DISCOVER 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>
                                                <PaymentCard CardCode="CA">MASTERCARD</PaymentCard>
                                            </PaymentCards>
                                        </GuaranteeAccepted>
                                    </GuaranteesAccepted>
                                </Guarantee>
                                <AdditionalDetails>
                                    <AdditionalDetail Description="Rate disclaimer information" Code="32">
                                        <Text>INCLUDES TAXES AND SURCHARGES</Text>
                                    </AdditionalDetail>
                                    <AdditionalDetail Description="Miscellaneous information" Code="14">
                                        <Text>COMMITMENT-HTTPS//CLEAN*MARRIOTT*COM</Text>
                                    </AdditionalDetail>
                                </AdditionalDetails>
                            </ConvertedRateInfo>
                        </RatePlan>
                    </RatePlans>
                </Room>
                <Room RoomType="Guest room" RoomTypeCode="42" RoomIndex="1">
                    <BedTypeOptions>
                        <BedTypes>
                            <BedType Description="King" Count="1" Code="3"/>
                        </BedTypes>
                    </BedTypeOptions>
                    <RoomDescription Name="STAY FOR BREAKFAST">
                        <Text>STAY FOR BREAKFAST, CONTINENTAL BREAKFAST FOR 2 GUESTS DAILY, GUEST ROOM, 1 KING</Text>
                    </RoomDescription>
                    <RatePlans>
                        <RatePlan RatePlanType="24" ProductCode="YBKE00" RatePlanName="STAY FOR BREAKFAST" RateKey="qzVpRuSVzCazmXNRPs3s7DCdLXRAC8+z4otKmbRQ9qtTDp5GWX01iO4PLA5pBk8oFHdRPPIMtV9EpyqYk9XJ17xcldOJxLL4Grh52j4vbMyz3KX78/waLj4RHx3TUr4SI/24UBtWHBYeFmJvFgljUao04zmOqdVVCz0pVbMHjoeit0geHEY44pQJp+Gmm3Jh1fDLigNqUfbnRqNqlJtiD00s2yV6nVKTO5VwagDUH1uri506sycabS9nGLpi9aBIYMbxDWxR2GBRLyjHl0tQIbsdfQIYYTLl1Qr0eS4uyW0dqAshKG3Pes6Hd9QYa5m5kGuVVENbnEmFrxxbACT3kNES4vrnW4EK4xhL5llF3H3ohuvPTPx9HzJM+9FYso4LY9/Oud3hvXY8QlEdG7ZIzWoTWYNQqSMxwlIAaKfgd+dkfTHcStJB9+J02/C6E4/9sO61qLGIg6m3D/L7sZkwDce5ubFjjsFawgJ9L/Xi+3wLcB3qqQrCsxgPXXqGIAz7Wq2B7wT6/HnR2YyfKvkPb3lLDaLfN9TKm+0WcB3gkTpbR/N1ZKhBdXzDSx8u/q7XkzZ+/Utu1fa3iYC4BbM8L46eM3OMIEVw8P+WnpDlc89k5SJH/7LO2YvS/DKXc+LbnbdPhYNMYrLbai4+jTlytKn3DuhnMo0PPOCxdmhL5HEbBON05yGT9Q+4KH9eK30ST5lbMps+L/2pSvLYJ0BAIXJ9YPyIQGDGQpcvC9xrxISNaA0MK8gvh/rV7GsOPJkVtxCi2pD5rItZwC006lAqov7CUw6BZz0/kzyBkVid3BXD8XfypZPxO5nceKP3Hug5" RateSource="100" PrepaidIndicator="false" LimitedAvailability="false">
                            <MealsIncluded MealPlanDescription="Breakfast" Breakfast="true" MealPlanCode="19" MealPlanIndicator="true"/>
                            <ConvertedRateInfo StartDate="2023-12-01" HighestNightlyRate="177.00" CurrencyCode="USD" AmountAfterTax="891.25" AdditionalFeesInclusive="true" AmountBeforeTax="775.00" AverageNightlyRate="178.25" ApproxTotalPrice="891.25" AverageNightlyRateBeforeTax="155.00" EndDate="2023-12-06" TaxInclusive="true">
                                <Rates>
                                    <Rate StartDate="2023-12-01" CurrencyCode="USD" AmountBeforeTax="137.00" EndDate="2023-12-02"/>
                                    <Rate StartDate="2023-12-02" CurrencyCode="USD" AmountBeforeTax="147.00" EndDate="2023-12-03"/>
                                    <Rate StartDate="2023-12-03" CurrencyCode="USD" AmountBeforeTax="152.00" EndDate="2023-12-04"/>
                                    <Rate StartDate="2023-12-04" CurrencyCode="USD" AmountBeforeTax="162.00" EndDate="2023-12-05"/>
                                    <Rate StartDate="2023-12-05" CurrencyCode="USD" AmountBeforeTax="177.00" EndDate="2023-12-06"/>
                                </Rates>
                                <Taxes CurrencyCode="USD" Amount="116.25">
                                    <Tax StartDate="2023-12-01" CurrencyCode="USD" Amount="20.55" EndDate="2023-12-02"/>
                                    <Tax StartDate="2023-12-04" CurrencyCode="USD" Amount="22.80" EndDate="2023-12-05"/>
                                </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 OffsetDropTime="BeforeArrival" OffsetTimeUnit="Day" OffsetUnitMultiplier="1"/>
                                    </CancelPenalty>
                                </CancelPenalties>
                                <Guarantee GuaranteeType="GUAR">
                                    <GuaranteesAccepted>
                                        <GuaranteeAccepted GuaranteeTypeCode="5" GuaranteeTypeDescription="Credit card">
                                            <PaymentCards>
                                                <PaymentCard CardCode="IK">MASTER CARD</PaymentCard>
                                                <PaymentCard CardCode="AX">AMERICAN EXPRESS</PaymentCard>
                                                <PaymentCard CardCode="DC">DINERS CLUB CARD</PaymentCard>
                                                <PaymentCard CardCode="DS">DISCOVER 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>
                                                <PaymentCard CardCode="CA">MASTERCARD</PaymentCard>
                                            </PaymentCards>
                                        </GuaranteeAccepted>
                                    </GuaranteesAccepted>
                                </Guarantee>
                                <AdditionalDetails>
                                    <AdditionalDetail Description="Rate disclaimer information" Code="32">
                                        <Text>INCLUDES TAXES AND SURCHARGES</Text>
                                    </AdditionalDetail>
                                    <AdditionalDetail Description="Miscellaneous information" Code="14">
                                        <Text>COMMITMENT-HTTPS//CLEAN*MARRIOTT*COM</Text>
                                    </AdditionalDetail>
                                </AdditionalDetails>
                            </ConvertedRateInfo>
                        </RatePlan>
                    </RatePlans>
                </Room>
            </Rooms>
        </HotelRateInfo>
    </HotelRateInfos>
</GetHotelRateInfoRS>