Get Hotel List

The Hotel List service returns hotels and their details according to the search criteria provided in the request.

More Detail: This service allows a series of optional search parameters which determine which hotels are to be returned. The parameters include HotelCode, HotelName, Marketer Codes, Chain Codes, Amenity Codes, and Property Types. Multiple number of these parameters can be passed in the request and the results will be filtered out according to the request. If no hotel is found matching with the Search criteria, nothing will be returned.

API Information

Target Audience
Sabre Travel Network
Current Version
v1.0.0
Authentication
Sessionless Token
Method/Endpoint
POST /v1.0.0/shop/hotels/list?mode=list HTTP/1.1

Ready to try the APIs?

Ready to get your hands dirty?

 Register Try the APIs

Ready to launch?

Ready to step up to the production level service? We're standing by to fit you for your spacesuit.

Request Production Key

Resources

Examples: request and response

Sample request

POST /v1.0.0/shop/hotels/list?mode=list
{
    "GetHotelListRQ": {
        "SearchCriteria": {
            "IncludedFeatures": true, 
            "HotelRefs": {
                "HotelRef": [
                    {
                        "HotelCode": "7521"
                    }, 
                    {
                        "HotelCode": "22390"
                    }, 
                    {
                        "HotelCode": "22570"
                    }
                ]
            }
        }
    }
}

Sample response

{
    "GetHotelListRS": {
        "ApplicationResults": {
            "status": "Complete"
        }, 
        "HotelList": {
            "HotelRef": [
                {
                    "HotelInfo": [
                        {
                            "HotelCode": "7521", 
                            "HotelName": "Hyatt Regency Auckland", 
                            "ChainCode": "HY", 
                            "ChainName": "Hyatt Hotels And Resorts", 
                            "MarketerCode": "HYATT", 
                            "MarketerName": "Hyatt", 
                            "Status": "Active", 
                            "Latitude": "-36.848000", 
                            "Longitude": "174.770000", 
                            "CountryCode": "NZ"
                        }, 
                        {
                            "HotelCode": "22390", 
                            "HotelName": "Hyatt Regency Suites Palm Springs", 
                            "ChainCode": "HY", 
                            "ChainName": "Hyatt Hotels And Resorts", 
                            "MarketerCode": "HYATT", 
                            "MarketerName": "Hyatt", 
                            "Status": "Active", 
                            "Latitude": "33.826473", 
                            "Longitude": "-116.546818", 
                            "CountryCode": "US", 
                            "Features": {
                                "Feature": [
                                    {
                                        "Code": "41", 
                                        "Description": "Free airport shuttle"
                                    }
                                ]
                            }
                        }, 
                        {
                            "HotelCode": "22570", 
                            "HotelName": "Hyatt Regency Suites Atlanta Northwest", 
                            "ChainCode": "HY", 
                            "ChainName": "Hyatt Hotels And Resorts", 
                            "MarketerCode": "HYATT", 
                            "MarketerName": "Hyatt", 
                            "Status": "Active", 
                            "Latitude": "33.90451", 
                            "Longitude": "-84.467759", 
                            "CountryCode": "US", 
                            "Features": {
                                "Feature": [
                                    {
                                        "Code": "42", 
                                        "Description": "Free parking"
                                    }
                                ]
                            }
                        }
                    ]
                }
            ]
        }
    }, 
    "Links": [
        {
            "rel": "self", 
            "href": "https://api.sabre.com/v1.0.0/shop/hotels/list?mode=list"
        }, 
        {
            "rel": "linkTemplate", 
            "href": "https://api.sabre.com/<version>/shop/hotels/list?mode=<mode>"
        }
    ]
}

Sample request

POST /v1.0.0/shop/hotels/list?mode=list
{
    "GetHotelListRQ": {
        "SearchCriteria": {
            "MaxResults": 50, 
            "OffSet": 1, 
            "IncludedFeatures": true, 
            "HotelPref": {
                "HotelName": "HYA", 
                "HotelStatus": "Active", 
                "MarketerCodes": {
                    "MarketerCode": [
                        "MARRIOTT", 
                        "HYATT"
                    ]
                }, 
                "ChainCodes": {
                    "ChainCode": [
                        "MC", 
                        "HY"
                    ]
                }, 
                "AmenityCodes": {
                    "Inclusive": true, 
                    "AmenityCode": [
                        "15"
                    ]
                }, 
                "PropertyTypes": {
                    "Inclusive": false, 
                    "PropertyType": [
                        "1", 
                        "2"
                    ]
                }
            }
        }
    }
}

Sample response

{
    "GetHotelListRS": {
        "ApplicationResults": {
            "status": "Complete"
        }, 
        "HotelList": {
            "HotelRef": [
                {
                    "MaxSearchResults": 4, 
                    "OffSet": 1, 
                    "HotelInfo": [
                        {
                            "HotelCode": "2518", 
                            "HotelName": "Hyatt Summerfield Suites Hartford North", 
                            "ChainCode": "HY", 
                            "ChainName": "Hyatt Hotels And Resorts", 
                            "MarketerCode": "HYATT", 
                            "MarketerName": "Hyatt", 
                            "Status": "Active", 
                            "Latitude": "41.87061", 
                            "Longitude": "-72.666113", 
                            "CountryCode": "US"
                        }, 
                        {
                            "HotelCode": "7521", 
                            "HotelName": "Hyatt Regency Auckland", 
                            "ChainCode": "HY", 
                            "ChainName": "Hyatt Hotels And Resorts", 
                            "MarketerCode": "HYATT", 
                            "MarketerName": "Hyatt", 
                            "Status": "Active", 
                            "Latitude": "-36.848000", 
                            "Longitude": "174.770000", 
                            "CountryCode": "NZ"
                        }, 
                        {
                            "HotelCode": "22390", 
                            "HotelName": "Hyatt Regency Suites Palm Springs", 
                            "ChainCode": "HY", 
                            "ChainName": "Hyatt Hotels And Resorts", 
                            "MarketerCode": "HYATT", 
                            "MarketerName": "Hyatt", 
                            "Status": "Active", 
                            "Latitude": "33.826473", 
                            "Longitude": "-116.546818", 
                            "CountryCode": "US", 
                            "Features": {
                                "Feature": [
                                    {
                                        "Code": "41", 
                                        "Description": "Free airport shuttle"
                                    }
                                ]
                            }
                        }, 
                        {
                            "HotelCode": "22570", 
                            "HotelName": "Hyatt Regency Suites Atlanta Northwest", 
                            "ChainCode": "HY", 
                            "ChainName": "Hyatt Hotels And Resorts", 
                            "MarketerCode": "HYATT", 
                            "MarketerName": "Hyatt", 
                            "Status": "Active", 
                            "Latitude": "33.90451", 
                            "Longitude": "-84.467759", 
                            "CountryCode": "US", 
                            "Features": {
                                "Feature": [
                                    {
                                        "Code": "42", 
                                        "Description": "Free parking"
                                    }
                                ]
                            }
                        }
                    ]
                }
            ]
        }
    }, 
    "Links": [
        {
            "rel": "self", 
            "href": "https://api.sabre.com/v1.0.0/shop/hotels/list?mode=list"
        }, 
        {
            "rel": "linkTemplate", 
            "href": "https://api.sabre.com/<version>/shop/hotels/list?mode=<mode>"
        }
    ]
}

Errors

A general HTTP status code is always returned. See the status codes and errors page for other common status codes and errors.

400 BAD REQUEST

The request was not valid.
The service does not support the data used in the request. For example, origin or destination in the request is not a valid IATA airport code.

If you receive this error:

{ status: "NotProcessed" type: "Validation" errorCode: "ERR.2SG.CLIENT.INVALID_REQUEST" timeStamp: "2016-05-20T11:43:34.599-05:00"
  message: "Request is invalid: Request payload is missing or it is not supported by the requested service" }

Ensure you:

  • have specified a content type header with a value of 'application/json'
  • are sending a JSON document in the HTTP POST's request body

Docs Navigation