Countries Lookup

The Countries Lookup API returns a list of origin and destination countries.

API Information

Target Audience
Sabre Travel Network
Current Version
v1
Authentication
Sessionless Token
Method/Endpoint
GET /v1/lists/supported/countries

These countries can be used as a filter in applicable REST APIs. This API is point of sale specific (each point of sale supports a unique list of origin and destination countries). Sabre® creates and maintains in the Sabre cache the lists of countries to which supported origin and/or destination airports belong.

Request

pointofsalecountry

string, optional

2-letter ISO 3166 country code

Retrieves data specific to a given point of sale country

Default value: US

Sample value: pointofsalecountry=DE

See usage notes: for more information on point of sale and supported point of sale countries.

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

Response

PointOfSale

string

Shows the Point of Sale country code to which the list of countries belongs

OriginCountries

array

Contains origin country objects:

  • CountryCode, string
  • CountryName, string
DestinationCountries

array

Contains destination country objects:

  • CountryCode, string
  • CountryName, string
CountryCode

string

The 2-letter ISO 3166 country code

CountryName

string

The name of the country that corresponds to CountryCode

Links array for the overall response

array

self link

object

Returns the URL of the request that generated the response

linkTemplate link

object

Formats a Travel Theme Lookup request

Sample code

Request

GET https://api.havail.sabre.com/v1/lists/supported/countries?pointofsalecountry=DE

Response

{
    "PointOfSale": "DE",
    "OriginCountries": [{
        "CountryCode": "AT",
        "CountryName": "Austria"
    }, {
        "CountryCode": "DE",
        "CountryName": "Germany"
    }, {
        "CountryCode": "GR",
        "CountryName": "Greece"
    }, {
        "CountryCode": "ID",
        "CountryName": "Indonesia"
    }, {
        "CountryCode": "MY",
        "CountryName": "Malaysia"
    }, {
        "CountryCode": "PT",
        "CountryName": "Portugal"
    }, {
        "CountryCode": "SG",
        "CountryName": "Singapore"
    }, {
        "CountryCode": "ZA",
        "CountryName": "South Africa"
    }, {
        "CountryCode": "ES",
        "CountryName": "Spain"
    }, {
        "CountryCode": "CH",
        "CountryName": "Switzerland"
    }, {
        "CountryCode": "TH",
        "CountryName": "Thailand"
    }, {
        "CountryCode": "TR",
        "CountryName": "Turkey"
    }, {
        "CountryCode": "AE",
        "CountryName": "United Arab Emirates"
    }, {
        "CountryCode": "GB",
        "CountryName": "United Kingdom"
    }, {
        "CountryCode": "US",
        "CountryName": "United States"
    }],
    "DestinationCountries": [{
        "CountryCode": "AU",
        "CountryName": "Australia"
    }, {
        "CountryCode": "AT",
        "CountryName": "Austria"
    }, {
        "CountryCode": "BG",
        "CountryName": "Bulgaria"
    }, {
        "CountryCode": "CA",
        "CountryName": "Canada"
    }, {
        "CountryCode": "CL",
        "CountryName": "Chile"
    }, {
        "CountryCode": "CN",
        "CountryName": "China"
    }, {
        "CountryCode": "CO",
        "CountryName": "Colombia"
    }, {
        "CountryCode": "CR",
        "CountryName": "Costa Rica"
    }, {
        "CountryCode": "HR",
        "CountryName": "Croatia"
    }, {
        "CountryCode": "CU",
        "CountryName": "Cuba"
    }, {
        "CountryCode": "CZ",
        "CountryName": "Czech Republic"
    }, {
        "CountryCode": "DK",
        "CountryName": "Denmark"
    }, {
        "CountryCode": "DO",
        "CountryName": "Dominican Republic"
    }, {
        "CountryCode": "EG",
        "CountryName": "Egypt"
    }, {
        "CountryCode": "ET",
        "CountryName": "Ethiopia"
    }, {
        "CountryCode": "FI",
        "CountryName": "Finland"
    }, {
        "CountryCode": "FR",
        "CountryName": "France"
    }, {
        "CountryCode": "DE",
        "CountryName": "Germany"
    }, {
        "CountryCode": "GR",
        "CountryName": "Greece"
    }, {
        "CountryCode": "HK",
        "CountryName": "Hong Kong"
    }, {
        "CountryCode": "HU",
        "CountryName": "Hungary"
    }, {
        "CountryCode": "IS",
        "CountryName": "Iceland"
    }, {
        "CountryCode": "IN",
        "CountryName": "India"
    }, {
        "CountryCode": "ID",
        "CountryName": "Indonesia"
    }, {
        "CountryCode": "IE",
        "CountryName": "Ireland"
    }, {
        "CountryCode": "IL",
        "CountryName": "Israel"
    }, {
        "CountryCode": "IT",
        "CountryName": "Italy"
    }, {
        "CountryCode": "LB",
        "CountryName": "Lebanon"
    }, {
        "CountryCode": "MY",
        "CountryName": "Malaysia"
    }, {
        "CountryCode": "MX",
        "CountryName": "Mexico"
    }, {
        "CountryCode": "MA",
        "CountryName": "Morocco"
    }, {
        "CountryCode": "NA",
        "CountryName": "Namibia"
    }, {
        "CountryCode": "NL",
        "CountryName": "Netherlands"
    }, {
        "CountryCode": "NZ",
        "CountryName": "New Zealand"
    }, {
        "CountryCode": "PE",
        "CountryName": "Peru"
    }, {
        "CountryCode": "PH",
        "CountryName": "Philippines"
    }, {
        "CountryCode": "PL",
        "CountryName": "Poland"
    }, {
        "CountryCode": "PT",
        "CountryName": "Portugal"
    }, {
        "CountryCode": "RO",
        "CountryName": "Romania"
    }, {
        "CountryCode": "RS",
        "CountryName": "Serbia"
    }, {
        "CountryCode": "SC",
        "CountryName": "Seychelles"
    }, {
        "CountryCode": "SG",
        "CountryName": "Singapore"
    }, {
        "CountryCode": "ZA",
        "CountryName": "South Africa"
    }, {
        "CountryCode": "ES",
        "CountryName": "Spain"
    }, {
        "CountryCode": "LK",
        "CountryName": "Sri Lanka"
    }, {
        "CountryCode": "CH",
        "CountryName": "Switzerland"
    }, {
        "CountryCode": "TH",
        "CountryName": "Thailand"
    }, {
        "CountryCode": "TN",
        "CountryName": "Tunisia"
    }, {
        "CountryCode": "TR",
        "CountryName": "Turkey"
    }, {
        "CountryCode": "AE",
        "CountryName": "United Arab Emirates"
    }, {
        "CountryCode": "GB",
        "CountryName": "United Kingdom"
    }, {
        "CountryCode": "US",
        "CountryName": "United States"
    }, {
        "CountryCode": "VN",
        "CountryName": "Viet Nam"
    }],
    "Links": [{
        "rel": "self",
        "href": "https://api.havail.sabre.com/v1/lists/supported/countries?pointofsalecountry=DE"
    }, {
        "rel": "linkTemplate",
        "href": "https://api.havail.sabre.com/v1/lists/supported/countries?pointofsalecountry=<pointofsalecountry>"
    }]
}

Usage notes

Country and airport codes

Point of sale

The point of sale is the geographic location in which the fare itinerary is eligible to be ticketed. The default point of sale (US) can be overridden with any supported point of sale country specified in the pointofsalecountry parameter. For example, the following will retrieve data specific to the Germany (DE) point of sale: pointofsalecountry=DE.

Errors

An HTTP status code is always returned.

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

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