Skip to main content

Get Hotel List

4.0.0
Hotel
Search
SOAP API
Travel Agency

The Get Hotel List (GetHotelListRQ) API provides the user with a list of hotel properties, together with details of the property, according to the search criteria entered. 

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
4.0.0
Authentication
Session or Sessionless Tokens
Service Action Code
GetHotelListRQ

What is it?

The Get Hotel List API is used to fetch up to a maximum limit of 5,000 hotels based on search parameters like Hotel Property Code, Hotel Name, Brand Code, Chain Codes, Amenity Codes, Property Type Codes, Property Level of Service, and Sabre Ratings.

Why use it?

Use this API in tandem with the Content Services for Lodging (CSL) suite of APIs to enhance your booking tools:

  • In addition to retrieving a list of hotels, the Get Hotel List API also displays basic hotel information.
  • Look for properties using specific search criteria or property IDs.
  • Further customize the response by specifying the kinds of descriptions you'd like to see in the response, such as amenities, location info, property type info, and more.

How does it work?

To use this API, pass property IDs along with optional multiple search parameters and filters:

Search parameters

  • Property Id is a mandatory input parameter, in case there are no search/filter criteria. The API user can request information for up to 5,000 properties in a single request

Additional search parameters and filters include:

  • Property Name - 3-20 characters which must be included in the property name
  • Property Status - Only active properties are included in the response
  • Brand information - Only properties belonging to certain brands and chains are included in the response
  • Chain - Can be used for both chains and master chains. Properties belonging to chains/Master chains requested are included in the response
  • Amenities - Only properties including the requested amenities are included in the response
  • Security Feature - Only properties including the requested security feature are included in the response
  • Sabre Rating - Rating filters to ensure all properties returned fall between the specified min/max rating values
  • Property Quality Codes - Only properties including the requested property quality codes are included in the response

The response will contain:

  • Property Id
  • Property name
  • Brand and Chain Information
  • Property status
  • Latitude and Longitude
  • Property contact information
  • Country code where the property is located
  • Amenities
  • Security feature
  • Sabre rating
  • Property Quality Codes

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="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>GetHotelListRQ</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>
        <GetHotelListRQ xmlns="http://services.sabre.com/hotel/list/v4" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" version="4.0.0" xsi:schemaLocation="http://services.sabre.com/hotel/list/v4 GetHotelListRQ_v4.xsd">
            <POS>
                <Source PseudoCityCode="TM61"/>
            </POS>
            <HotelRefs>
                <HotelRef HotelCode="100095296" CodeContext="GLOBAL"/>
                <HotelRef HotelCode="100095298" CodeContext="GLOBAL"/>
                <HotelRef HotelCode="100036910" CodeContext="GLOBAL"/>
                <HotelRef HotelCode="100063782" CodeContext="GLOBAL"/>
            </HotelRefs>
            <HotelPref>
                <SabreRating Min="3.0" Max="5.0"/>
            </HotelPref>
            <HotelInfoRef>
                <LocationInfo>true</LocationInfo>
                <Amenities>true</Amenities>
                <PropertyTypeInfo>true</PropertyTypeInfo>
                <PropertyQualityInfo>true</PropertyQualityInfo>
                <SecurityFeatures>true</SecurityFeatures>
            </HotelInfoRef>
        </GetHotelListRQ>
    </SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Sample Response
<GetHotelListRS>           
    <HotelInfos MaxSearchResults="4">
        <HotelInfo BrandName="MyFidelio" HotelCode="100095296" ChainName="MyFidelio" ChainCode="IQ" CodeContext="GLOBAL" SabreRating="4.0" BrandCode="10402" SabreHotelCode="49504" HotelName="Sokos Hotel Tahkovuori">
            <LocationInfo Latitude="63.288932" Longitude="28.040266">
                <Address>
                    <AddressLine1>Saaskiniementie 560</AddressLine1>
                    <CityName CityCode="KUO">Nilsia</CityName>
                    <PostalCode>73310</PostalCode>
                    <CountryName Code="FI">Finland</CountryName>
                </Address>
                <Contact Phone="358-17-192 30 00" Fax="358-17-192 30 01"/>
            </LocationInfo>
            <Amenities>
                <Amenity Description="Wheelchair access" Code="101"/>
                <Amenity Description="Meal plan available" Code="162"/>
                <Amenity Description="Lounges/bars" Code="165"/>
                <Amenity Description="Non-smoking rooms (generic)" Code="198"/>
                <Amenity Description="Family Room" Code="2014"/>
                <Amenity Description="Rollaway adult" Code="2016"/>
                <Amenity Description="Crib charge" Code="2017"/>
                <Amenity Description="Pets allowed" Code="224"/>
                <Amenity Description="Complimentary breakfast" Code="227">Buffet</Amenity>
                <Amenity Description="Conference facilities" Code="24"/>
                <Amenity Description="Kitchenette" Code="262"/>
                <Amenity Description="Snow skiing" Code="272"/>
                <Amenity Description="Children programs" Code="289"/>
                <Amenity Description="Free parking" Code="42"/>
                <Amenity Description="Game room" Code="44"/>
                <Amenity Description="Health club" Code="48"/>
                <Amenity Description="Indoor pool" Code="54"/>
                <Amenity Description="Hot Tub" Code="55"/>
                <Amenity Description="Nightclub" Code="62"/>
                <Amenity Description="Pool" Code="71"/>
                <Amenity Description="Restaurant" Code="76"/>
                <Amenity Description="Room service" Code="77"/>
            </Amenities>
            <PropertyQualityInfo>
                <PropertyQuality Description="Regular" Code="5"/>
            </PropertyQualityInfo>
        </HotelInfo>
        <HotelInfo BrandName="Louvre Hotels" HotelCode="100095298" ChainName="Louvre Hotels" ChainCode="NN" CodeContext="GLOBAL" SabreRating="3.0" BrandCode="10314" SabreHotelCode="49505" HotelName="Campanile - Rennes Cleunay">
            <LocationInfo Latitude="48.10317" Longitude="-1.71137">
                <Address>
                    <AddressLine1>120 Euene Pottier</AddressLine1>
                    <CityName CityCode="RNS">Rennes</CityName>
                    <PostalCode>35000</PostalCode>
                    <CountryName Code="FR">France</CountryName>
                </Address>
                <Contact Phone="33-2-99 30 45 45" Fax="33-2-99 31 06 71"/>
            </LocationInfo>
            <Amenities>
                <Amenity Description="Car rental desk" Code="15">NOT AVAILABLE</Amenity>
                <Amenity Description="Meal plan available" Code="162"/>
                <Amenity Description="Pets allowed" Code="224"/>
                <Amenity Description="Golf" Code="236"/>
                <Amenity Description="Conference facilities" Code="24"/>
                <Amenity Description="Free parking" Code="42">NOT AVAILABLE</Amenity>
            </Amenities>
            <PropertyQualityInfo>
                <PropertyQuality Description="Economy" Code="6"/>
            </PropertyQualityInfo>
        </HotelInfo>
        <HotelInfo BrandName="undefined" HotelCode="100036910" ChainName="Accor Hotels" ChainCode="RT" CodeContext="GLOBAL" SabreRating="3.0" BrandCode="10000" SabreHotelCode="20169" HotelName="Ibis Bordeaux Le Lac">
            <LocationInfo Latitude="44.8898" Longitude="-0.56454">
                <Address>
                    <AddressLine1>Rue Du Petit Barail</AddressLine1>
                    <CityName CityCode="BOD">BORDEAUX</CityName>
                    <PostalCode>33300</PostalCode>
                    <CountryName Code="FR">France</CountryName>
                </Address>
                <Contact Phone="33-5-56509650" Fax="33-5-56396352"/>
            </LocationInfo>
            <Amenities>
                <Amenity Description="Wheelchair access" Code="101"/>
                <Amenity Description="Car rental desk" Code="15">N</Amenity>
                <Amenity Description="Non-smoking rooms (generic)" Code="198"/>
                <Amenity Description="Conference facilities" Code="24"/>
                <Amenity Description="Data port" Code="255"/>
                <Amenity Description="High speed internet access" Code="259">According to local phone cost</Amenity>
                <Amenity Description="Children programs" Code="289"/>
                <Amenity Description="Free parking" Code="42">Y-OUTDOOR</Amenity>
                <Amenity Description="Dry cleaning" Code="96"/>
            </Amenities>
            <SecurityFeatures>
                <SecurityFeature Description="Complies with Local/State/Federal fire laws" Code="9">Y</SecurityFeature>
            </SecurityFeatures>
            <PropertyQualityInfo>
                <PropertyQuality Description="Economy" Code="6"/>
            </PropertyQualityInfo>
        </HotelInfo>
        <HotelInfo BrandName="undefined" HotelCode="100063782" ChainName="Red Lion Hotels" ChainCode="RL" CodeContext="GLOBAL" SabreRating="3.0" BrandCode="10000" SabreHotelCode="33555" HotelName="Red Lion At The Park">
            <LocationInfo Latitude="47.664898" Longitude="-117.416036">
                <Address>
                    <AddressLine1>W 303 North River Drive</AddressLine1>
                    <CityName CityCode="GEG">Spokane</CityName>
                    <StateProv StateCode="WA"/>
                    <PostalCode>99201</PostalCode>
                    <CountryName Code="US">United States of America</CountryName>
                </Address>
                <Contact Phone="1-509-326-8000" Fax="1-509-325-7329"/>
            </LocationInfo>
            <Amenities>
                <Amenity Description="Wheelchair access" Code="101"/>
                <Amenity Description="Complimentary in-room coffee or tea" Code="137"/>
                <Amenity Description="Meal plan available" Code="162">Y</Amenity>
                <Amenity Description="Lounges/bars" Code="165">1</Amenity>
                <Amenity Description="Wireless internet connection in public areas" Code="179"/>
                <Amenity Description="Non-smoking rooms (generic)" Code="198">400</Amenity>
                <Amenity Description="Rooms with Balcony" Code="2003"/>
                <Amenity Description="Refrigerator" Code="2006"/>
                <Amenity Description="Rollaway adult" Code="2016"/>
                <Amenity Description="Crib charge" Code="2017"/>
                <Amenity Description="Extra person" Code="2018"/>
                <Amenity Description="Exhibition/convention floor" Code="215"/>
                <Amenity Description="Concierge desk" Code="22"/>
                <Amenity Description="Pets allowed" Code="224">Y</Amenity>
                <Amenity Description="Business center" Code="228"/>
                <Amenity Description="Conference facilities" Code="24"/>
                <Amenity Description="Data port" Code="255"/>
                <Amenity Description="ADA accessible" Code="258"/>
                <Amenity Description="High speed internet access" Code="259"/>
                <Amenity Description="Interior corridors" Code="260"/>
                <Amenity Description="High speed wireless" Code="261"/>
                <Amenity Description="Airport shuttle service" Code="282" ComplimentaryInd="true"/>
                <Amenity Description="Executive floor" Code="34"/>
                <Amenity Description="Free parking" Code="42">Selfparking is1</Amenity>
                <Amenity Description="Game room" Code="44"/>
                <Amenity Description="Health club" Code="48"/>
                <Amenity Description="Indoor pool" Code="54"/>
                <Amenity Description="Outdoor pool" Code="66"/>
                <Amenity Description="Pool" Code="71"/>
                <Amenity Description="Restaurant" Code="76"/>
                <Amenity Description="Room service" Code="77"/>
                <Amenity Description="Dry cleaning" Code="96"/>
            </Amenities>
            <SecurityFeatures>
                <SecurityFeature Description="Complies with Local/State/Federal fire laws" Code="9">Y</SecurityFeature>
            </SecurityFeatures>
            <PropertyTypeInfo>
                <PropertyType Description="Conference center" Code="9"/>
            </PropertyTypeInfo>
            <PropertyQualityInfo>
                <PropertyQuality Description="First Class" Code="2001"/>
            </PropertyQualityInfo>
        </HotelInfo>
    </HotelInfos>
</GetHotelListRS>