Point of Sale Country Code Lookup

Point of Sale Country Code Lookup is a supplemental API that retrieves a list of supported point of sale country codes and associated country names. The country codes can be passed as a parameter in certain REST API requests (those which support a 'pointofsalecountry' parameter). When a point of sale country is submitted with the request, only data related to that point of sale will be included in the response.

Data used for point of sale countries

  • Sabre® defines supported point of sale countries, and maintains in Sabre cache the lists of countries.

API suitability

  • To retrieve a list of supported point of sale country codes.
  • To obtain country codes to use as a request parameter for other REST APIs.

HTTP method and endpoint

GET /v1/lists/supported/pointofsalecountries

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

Countries

array

Repeats CountryCode and CountryName for each supported country, along with a cityPairsLookup link for each country.

CountryCode

string

The 2-letter ISO 3166 country code

See usage notes: for links to country code sources.

CountryName

string

The name of the country that corresponds to CountryCode

Links

array

Consists of cityPairsLookup link and CountryCode object

cityPairsLookup

object

Invokes a City Pairs Lookup API request to retrieve all origin and destination pairs supported for specified point of sale country code

Links array for the overall response

array

For more information, see links nodes in response payloads.

Links

array

Consists of self and linkTemplate links

self

object

Returns the URL of the request that generated the response

linkTemplate

object

A link that formats a Point of Sale country codeLookup API request

Example: request and response

Point of Sale Country Code Lookup requests do not have variations or parameters. The URI requests a list of all point of sale countries.

https://api.sabre.com/v1/lists/supported/pointofsalecountries  HTTP/1.1
{
    "Countries": [{
        "CountryCode": "DE",
        "CountryName": "Germany",
        "Links": [{
            "rel": "cityPairsLookup",
            "href": "https://api.sabre.com/v1/lists/supported/shop/flights/origins-destinations?destinationregion=<destinationregion>&originregion=<originregion>&destinationcountry=<destinationcountry>&origincountry=<origincountry>&pointofsalecountry=DE"
        }]
    }, {
        "CountryCode": "GR",
        "CountryName": "Greece",
        "Links": [{
            "rel": "cityPairsLookup",
            "href": "https://api.sabre.com/v1/lists/supported/shop/flights/origins-destinations?destinationregion=<destinationregion>&originregion=<originregion>&destinationcountry=<destinationcountry>&origincountry=<origincountry>&pointofsalecountry=GR"
        }]
    }, {
        "CountryCode": "IT",
        "CountryName": "Italy",
        "Links": [{
            "rel": "cityPairsLookup",
            "href": "https://api.sabre.com/v1/lists/supported/shop/flights/origins-destinations?destinationregion=<destinationregion>&originregion=<originregion>&destinationcountry=<destinationcountry>&origincountry=<origincountry>&pointofsalecountry=IT"
        }]
    }, {
        "CountryCode": "MX",
        "CountryName": "Mexico",
        "Links": [{
            "rel": "cityPairsLookup",
            "href": "https://api.sabre.com/v1/lists/supported/shop/flights/origins-destinations?destinationregion=<destinationregion>&originregion=<originregion>&destinationcountry=<destinationcountry>&origincountry=<origincountry>&pointofsalecountry=MX"
        }]
    }, {
        "CountryCode": "US",
        "CountryName": "United States",
        "Links": [{
            "rel": "cityPairsLookup",
            "href": "https://api.sabre.com/v1/lists/supported/shop/flights/origins-destinations?destinationregion=<destinationregion>&originregion=<originregion>&destinationcountry=<destinationcountry>&origincountry=<origincountry>&pointofsalecountry=US"
        }]
    }, {
        "CountryCode": "CA",
        "CountryName": "Canada",
        "Links": [{
            "rel": "cityPairsLookup",
            "href": "https://api.sabre.com/v1/lists/supported/shop/flights/origins-destinations?destinationregion=<destinationregion>&originregion=<originregion>&destinationcountry=<destinationcountry>&origincountry=<origincountry>&pointofsalecountry=CA"
        }]
    }],
    "Links": [{
        "rel": "self",
        "href": "https://api.sabre.com/v1/lists/supported/pointofsalecountries"
    }, {
        "rel": "linkTemplate",
        "href": "https://api.sabre.com/v1/lists/supported/pointofsalecountries"
    }]
}

Usage notes

Country 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 fare data specific to the Germany (DE) point of sale: pointofsalecountry=DE. The response will be fares eligible for sale in Germany.

Errors

A general HTTP status code is always returned.

Errors that are specific to this API follow. For information about the error response format, see the: status codes and errors page.

Note — Optional parameters are checked for errors when a value is supplied.

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 origin or dates.

An origin or destination in the request is not a valid IATA airport code.

The origin or destination are not supported.

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.

Docs Navigation