Get Hotel List

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

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

In 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.

Resources

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

Sample code

Request

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

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.havail.sabre.com/v1.0.0/shop/hotels/list?mode=list"
        }, 
        {
            "rel": "linkTemplate", 
            "href": "https://api.havail.sabre.com/<version>/shop/hotels/list?mode=<mode>"
        }
    ]
}

Request

POST https://api.havail.sabre.com/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"
                    ]
                }
            }
        }
    }
}

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.havail.sabre.com/v1.0.0/shop/hotels/list?mode=list"
        }, 
        {
            "rel": "linkTemplate", 
            "href": "https://api.havail.sabre.com/<version>/shop/hotels/list?mode=<mode>"
        }
    ]
}

Errors

An HTTP status code is always returned. For information about the error response format, see the: Sabre APIs: errors page.

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