Countries Lookup

The Countries Lookup API retrieves a list of origin and destination 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).

Data used by Countries Lookup

  • Sabre® creates and maintains in the Sabre cache the lists of countries to which supported origin and/or destination airports belong.

HTTP method and endpoint

GET /v1/lists/supported/countries

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.

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

For more information, see Links nodes in response payloads.

self link

object

Returns the URL of the request that generated the response

linkTemplate link

object

Formats a Travel Theme Lookup request

Example: request and response

GET https://api.sabre.com/v1/lists/supported/countries?pointofsalecountry=DE HTTP/1.1
 {
  "PointOfSale": "DE",
  "OriginCountries":
  [
   {
    "CountryCode": "AT",
    "CountryName": "Austria"
   },
   {
    "CountryCode": "DE",
    "CountryName": "Germany"
   },
   ...
  ],
  "DestinationCountries":
  [
   {
    "CountryCode": "AU",
    "CountryName": "Australia"
   },
   ...
  ],
  "Links":
  [
   {
   "rel": "self",
   "href": "https://api.sabre.com/v1/lists/supported/countries?pointofsalecountry=DE"
  },
  {
   "rel": "linkTemplate",
   "href": "https://api.test.sabre.com/v1/lists/supported/countries?pointofsalecountry=<pointofsalecountry>"
   }
  ]
 }

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.

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