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.

API Information

Target Audience
All Sabre APIs Customers
Current Version
v1.0.0
Authentication
Sessionless Token
Method/Endpoint
GET /v1/lists/supported/shop/themes/{theme}

A theme is defined as a genre or a category of travel based on geography, point of interest, or recreational activity. For example: beaches, national parks, or skiing. 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

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

Request

Path Variable

The Sabre 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

Sample code

Request

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

GET https://api.havail.sabre.com/v1/lists/supported/shop/themes/BEACH HTTP/1.1

Response

{
    Destinations: [{
        Destination: "BOS",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.havail.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.havail.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.havail.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.havail.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.havail.sabre.com/v1/lists/supported/cities/FMY/airports"
        }]
    }, {
        Destination: "HNL",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.havail.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.havail.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.havail.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.havail.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.havail.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.havail.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.havail.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.havail.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.havail.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.havail.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.havail.sabre.com/v1/lists/supported/cities/ORL/airports"
        }]
    }, {
        Destination: "PBI",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.havail.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.havail.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.havail.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.havail.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.havail.sabre.com/v1/lists/supported/cities/SEA/airports"
        }]
    }, {
        Destination: "SJC",
        Type: "Airport",
        Links: [{
            rel: "shopTemplate",
            href: "https://api.havail.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.havail.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.havail.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.havail.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.havail.sabre.com/v1/lists/supported/cities/TPA/airports"
        }]
    }],
    Links: [{
        rel: "self",
        href: "https://api.havail.sabre.com/v1/lists/supported/shop/themes/BEACH"
    }, {
        rel: "linkTemplate",
        href: "https://api.havail.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

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

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.

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