Travel Seasonality Airports Lookup

The Travel Seasonality Airports Lookup API retrieves a list of our supported destinations.

In detail: these destinations can then be passed in a Travel Seasonality API request to retrieve seasonality for a given destination. A destination can be either an airport code or a multi-airport city (MAC) code. If a MAC is used as a destination, results will represent all airports belonging to the MAC.

Travel Seasonality Airports Lookup data

  • Sabre® creates and maintains in the Sabre cache the list of destination airports that can be used with the Travel Seasonality API. The list represents the most commonly booked destinations.

HTTP method and endpoint

GET /v1/lists/supported/historical/seasonality/airports

Request

country

string, optional

2-letter ISO 3166 country code

Retrieves destination airport codes located in this specified country

Only one value is accepted

Default: all destination countries

Sample value: country=MX

See usage notes: for links to country code sources.

region

string, optional

Retrieves destination airport codes that are associated with the specified region

Only one value accepted

Valid values:

  • Africa
  • Asia Pacific
  • Europe
  • Latin America
  • Middle East
  • North America

Sample value: region=Europe

Response

DestinationLocations

array

  • DestinationLocation, object
DestinationLocation

object

Repeats associated destination information:

  • AirportCode, string
  • AirportName, string
  • CityName, string
  • CountryCode, string
  • CountryName, string
  • RegionName, string
AirportCode

string

3-letter IATA airport code

Sample value: DFW

AirportName

string

The name of the airport that is associated with the airport code

Sample value: Dallas/Fort Worth International Airport

CityName

string

The city name that is associated with the airport code

Sample value: Dallas

CountryCode

string

The 2-letter ISO 3166 country code that is associated with the airport code

Sample value: US

CountryName

string

The name of the country that is associated with the country code

Sample value: United States

RegionName

string

The name of the region that is assigned to the country

Sample value: North America

Overall response links

Link nodes

array

See usage notes: for more information on link nodes.

array

For more information, see Links nodes in response payloads.

self

object

Returns the URL of the request that generated the response

linkTemplate

object

Formats a Travel Seasonality Airports Lookup request

Example: request and response

This example demonstrates a request for all destination airports in the European region.

GET https://api.sabre.com/v1/lists/supported/historical/seasonality/airports?region=EUROPE HTTP/1.1
{
    DestinationLocations: [{
        DestinationLocation: {
            AirportCode: "AMS",
            AirportName: "Amsterdam-Schiphol",
            CityName: "Amsterdam",
            CountryCode: "NL",
            CountryName: "Netherlands",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "IST",
            AirportName: "Ataturk",
            CityName: "Istanbul",
            CountryCode: "TR",
            CountryName: "Turkey",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "MAD",
            AirportName: "Barajas",
            CityName: "Madrid",
            CountryCode: "ES",
            CountryName: "Spain",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "BCN",
            AirportName: "Barcelona",
            CityName: "Barcelona",
            CountryCode: "ES",
            CountryName: "Spain",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "CDG",
            AirportName: "Ch. De Gaulle",
            CityName: "Paris",
            CountryCode: "FR",
            CountryName: "France",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "ATH",
            AirportName: "Eleftherios Venizelos",
            CityName: "Athens",
            CountryCode: "GR",
            CountryName: "Greece",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "FCO",
            AirportName: "Fiumicino",
            CityName: "Rome",
            CountryCode: "IT",
            CountryName: "Italy",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "MUC",
            AirportName: "Franz Josef Strauss",
            CityName: "Munich",
            CountryCode: "DE",
            CountryName: "Germany",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "LHR",
            AirportName: "Heathrow",
            CityName: "London",
            CountryCode: "GB",
            CountryName: "United Kingdom",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "FRA",
            AirportName: "International",
            CityName: "Frankfurt",
            CountryCode: "DE",
            CountryName: "Germany",
            RegionName: "Europe"
        }
    }, {
        DestinationLocation: {
            AirportCode: "SVO",
            AirportName: "Sheremetyevo",
            CityName: "Moscow",
            CountryCode: "RU",
            CountryName: "Russian Federation",
            RegionName: "Europe"
        }
    }],
    Links: [{
        rel: "self",
        href: "https://api.sabre.com/v1/lists/supported/historical/seasonality/airports?region=EUROPE"
    }, {
        rel: "linkTemplate",
        href: "https://api.sabre.com/v1/lists/supported/historical/seasonality/airports?country=<country>&region=<region>"
    }]
}

Usage notes

Country and airport codes

Links nodes

  • Sabre REST APIs have one or more Links nodes that combine related URI resources in a response. For more information, see the links nodes page.

Errors

An HTTP status code is always returned.

For more information about HTTP status codes and error response formats, see Sabre APIs: common errors.

Note — Optional parameters are checked for errors only when a value is supplied. For example, we do not return an error if an empty value is passed for region since it is an optional parameter.

Status 404 NOT FOUND

No results were found

The service cannot find data to fulfill the request using the filters that you applied.

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.

Status 400 BAD REQUEST

Parameter 'country' must be country code
A country code is an invalid value, or not a country code we support.
Parameter 'region' must be one of '{Africa,Asia Pacific,Europe,Latin America,Middle East,North America}'

A region is not valid.

Docs Navigation