Theme Airport Lookup

The Theme Airport Lookup API returns a list of airport and multi-airport city (MAC) codes that are associated with a given Sabre travel theme. A theme is similar to a travel category, and is based on geography, points of interest, or recreational activities, such as beaches, national parks, or skiing.

Data used by the Theme Airport Lookup API

  • Sabre® creates and maintains the file of themes with airports in the  Sabre cache.
  • All of the airport codes that this API retrieves are available as destinations in our list of city pairs. See usage notes: for more information on retrieving a list of our supported city pairs of origin and destination airports using the City Pairs Lookup API.

API suitability

  • To get a reference of destination airport codes that have been associated with a theme. See usage notes: for more information on retrieving a list of themes using the Travel Theme Lookup API.

HTTP method and endpoint

GET /v1/lists/supported/shop/themes/{theme}

Request

This request has a theme URI variable. Any valid theme value, e.g., BEACH, can be substituted for {theme}.

Valid values: BEACH, DISNEY, GAMBLING, HISTORIC, MOUNTAINS, NATIONAL-PARKS, OUTDOORS, ROMANTIC, SHOPPING, SKIING, THEME-PARK, CARIBBEAN

Response

Destinations

array

Returns all theme objects:

  • Destination, string
  • Type, string
  • Links, array
Destination

string

The 3-letter IATA airport or multi-airport city (MAC) code that is associated with the theme in the request

See usage notes: for more information on the Airports at Cities Lookup API.

Type

string

The type of response that corresponds to Destination

Valid values: City, Airport

Note: "City" Typereflects a multi-airport city (MAC) destination response; whereas, "Airport" Typereflects an airport code destination.

Links

array

Contains a shopTemplate link for every Destination object

Contains an AirportsInCity object for every multi-airport city (MAC) code

Links.AirportsInCity

object

Retrieves all airport codes that belong to a multi-airport city (MAC) code and returns as link objects

Invokes an Airports at Cities Lookup API request

Note: Only a MAC destination response Type of "City" will contain this link.

See usage notes: for more information on the Airports at Cities Lookup API.

Links.shopTemplate

array

Invokes a Destination Finder API request that will retrieve lead fares to destinations based on the theme in the request

See usage notes: for more information on the Destination Finder API.

Overall response Links array

Returns links

Links

array

Includes self and linkTemplate links

self

object

Returns the URL of the request that generated the response

linkTemplate

object

Formats a Theme Airport Lookup request, with a placeholder for a theme

Example: request and response

This request retrieves a list of airport codes and multi-airport city (MAC) codes that are associated with the BEACH theme.

GET https://api.sabre.com/v1/lists/supported/shop/themes/BEACH HTTP/1.1
{
    Destinations: [{
        Destination: "BOS",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "CHS",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "FLL",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "FMY",
        Type: "City",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }, {
            rel: "airportsInCity",
            href: "https://api.sabre.com/v1/lists/supported/cities/FMY/airports"
        }]
    }, {
        Destination: "HNL",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "ITO",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "KOA",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "LAX",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "LGB",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "LIH",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "MCO",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "MIA",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "OGG",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "ORL",
        Type: "City",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }, {
            rel: "airportsInCity",
            href: "https://api.sabre.com/v1/lists/supported/cities/ORL/airports"
        }]
    }, {
        Destination: "PBI",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "RDU",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "RSW",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "SEA",
        Type: "City",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }, {
            rel: "airportsInCity",
            href: "https://api.sabre.com/v1/lists/supported/cities/SEA/airports"
        }]
    }, {
        Destination: "SJC",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "SJU",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "SNA",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }]
    }, {
        Destination: "TPA",
        Type: "City",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.sabre.com/v1/shop/flights/fares?origin=<origin>&departuredate=<departuredate>&returndate=<returndate>&location=<location>&theme=BEACH&minfare=<minfare>&maxfare=<maxfare>&lengthofstay=<lengthofstay>&earliestdeparturedate=<earliestdeparturedate>&latestdeparturedate=<latestdeparturedate>&pointofsalecountry=<pointofsalecountry>&region=<region>&topdestinations=<topdestinations>"
        }, {
            rel: "airportsInCity",
            href: "https://api.sabre.com/v1/lists/supported/cities/TPA/airports"
        }]
    }],
    Links: [{
        rel: "self",
        href: "https://api.sabre.com/v1/lists/supported/shop/themes/BEACH"
    }, {
        rel: "linkTemplate",
        href: "https://api.sabre.com/v1/lists/supported/shop/themes/<theme>"
    }]
}

Usage notes

Airport codes

Airports at Cities Lookup API

The Theme Airport Lookup API returns airport and multi-airport city (MAC) codes that are associated with a theme.

To identify the airports associated with a multi-airport city (MAC) code, use the Airports at Cities Lookup API and pass one of the MACs in the request. The Airports at Cities Lookup API retrieves our list of major airport, rail station and other codes that are associated with a single multi-airport city (MAC) code in the request.

City Pairs Lookup API

To get a list of our supported city pairs of origin and destination airports, use the City Pairs Lookup API. You can pass any of these origin and destination airport codes in a request.

Destination Finder API

The Destination Finder API retrieves a then current nonstop lead fare and an overall lead fare available to destinations from a specific origin on round-trip travel dates from the Sabre© cache.

Travel Theme Lookup API

To get a list of valid themes, use the Travel Theme Lookup API. The response will be a list of themes, such as BEACH, GAMBLING.

Errors

An HTTP status code is always returned.

Errors that are specific to this API follow. For more information about HTTP status codes and application error response format, see Sabre APIs: common errors.

404 NOT_FOUND

No results were found

The service cannot find data to fulfill the parameters in the request. For example, data is not available for the theme.

Status 413 FULL head

The API returns this error when a request URI is too long. For example, the HTTP request’s query string exceeds the server limit.

The response will be empty as a result.

Please consider reducing the number of request parameters in the URI or separating parameters into multiple HTTP requests.

400 BAD REQUEST

Parameter 'theme' must be one of '{BEACH,DISNEY,GAMBLING,HISTORIC,MOUNTAINS,NATIONAL-PARKS,OUTDOORS,ROMANTIC,SHOPPING,SKIING,THEME-PARK,CARIBBEAN}'

A theme is not correct, not recognized, or not valid.

Docs Navigation