Flights To

The Flights To API returns 20 of the lowest published fares available for a given destination.

API Information

Target Audience
All Sabre APIs Customers
Current Version
v1
Authentication
Sessionless Token
Method/Endpoint
GET /v1/shop/flights/cheapest/fares/

In detail: the API uses the Travel Insight engine to retrieve shopped fare data for the next 192 days from the API request to find the lowest published fares available in the Sabre® cache for a given destination. In total, each request returns the 20 lowest published fares: a nonstop lead fare or overall lead fare per origin for a given destination. For example, if "DFW" (Dallas/Fort Worth International) is used as destination, then the 20 lowest published fares to "DFW" (from any available origin) will be returned.

Business use case

You could use this API to compile a list of the 20 least expensive flight options to a popular destination, such as New York City. To search for fares to New York City, use the multi-airport city (MAC) code "NYC" for destination. From this list, customers can choose a desired origin. Then the application could use the shop link in the response to make a subsequent request to call the InstaFlights Search API. The response will be a list of the lowest published fares for the selected city pair.

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

Data used by Flights To API

  • The in-scope shopping responses used by Sabre to generate the lead fares for this API are the shopping responses to shopping requests from a PCC operated by Sabre.
  • All fares are for single adult, roundtrip travel in the economy class of service.
  • Total fares: All taxes and fees are included; however, ancillary fees charged by airlines, such as baggage and preferred seating, are not included.
  • Flight types: nonstop, connecting, and flights with stops
  • Origin: major airports and multi-airport cities throughout the world that we support
  • Destination: major airports throughout the world that we support
  • Advance fares: A maximum of 192 days

Request

Path Variable

destination

3-letter IATA code of the destination airport or multi-airport city (MAC) code

If a multi-airport city (MAC) code is used, then only the lowest fare associated with any of the airports belonging to the MAC will be returned

Query Parameter

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

DestinationLocation

string

Returns the specified 3-letter IATA destination airport or multi-airport city (MAC) code

FareInfo

array

Repeats associated lead fare and date/time information:

  • OriginLocation, string
  • DepartureDateTime, string
  • ReturnDateTime, string
  • Links, array
  • CurrencyCode, string
  • LowestFare, string or object
FareInfo.OriginLocation

string

3-letter IATA origin airport code

FareInfo.DepartureDateTime

string

The departure date in the time zone of the origin airport

Data format: YYYY-MM-DDTHH:MM:SS

FareInfo.ReturnDateTime

string

The return date in the time zone of the destination airport

Data format: YYYY-MM-DDTHH:MM:SS

FareInfo.Links

array

Repeats associated lead fare and destination links:

  • shop, object
Links.shop

object

Invokes an InstaFlights Search request

If a multi-airport city (MAC) code is used as destination, then the shop link will contain the MAC.

See usage notes: for more information on the InstaFlights Search API.

FareInfo.CurrencyCode

string

3-letter currency code

Sample values: USD

FareInfo.LowestFare

object

Returns associated lead fare information:

  • Fare, number
  • AirlineCodes, array
LowestFare.Fare

number

The lead fare from the Sabre cache for the origin

LowestFare.AirlineCodes

array

2-letter IATA marketing airline company code

If more than one airline offers the lowest overall fare, then multiple airline codes will be returned.

Overall response links

Links

array

  • self, object
  • linkTemplate, object

See usage notes: for more information on link nodes.

self

object

Returns the URL of the request that generated the response

linkTemplate

object

Formats a Flights To request

Examples: request and response

This example demonstrates a request for 20 of the lowest published fares available to "DFW" (Dallas/Fort Worth International).

GET https://api.havail.sabre.com/v1/shop/flights/cheapest/fares/DFW HTTP/1.1 
{
    DestinationLocation: "DFW",
    FareInfo: [{
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "F9"
            ],
            Fare: 58
        },
        OriginLocation: "DEN",
        DepartureDateTime: "2015-09-02T00:00:00",
        ReturnDateTime: "2015-09-02T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=DEN&destination=DFW&departuredate=2015-09-02&returndate=2015-09-02&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA"
            ],
            Fare: 74.6
        },
        OriginLocation: "BWI",
        DepartureDateTime: "2015-09-23T00:00:00",
        ReturnDateTime: "2015-09-23T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=BWI&destination=DFW&departuredate=2015-09-23&returndate=2015-09-23&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "NK"
            ],
            Fare: 80.2
        },
        OriginLocation: "DTW",
        DepartureDateTime: "2016-02-13T00:00:00",
        ReturnDateTime: "2016-02-13T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=DTW&destination=DFW&departuredate=2016-02-13&returndate=2016-02-13&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "NK"
            ],
            Fare: 80.6
        },
        OriginLocation: "FLL",
        DepartureDateTime: "2015-09-10T00:00:00",
        ReturnDateTime: "2015-09-10T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=FLL&destination=DFW&departuredate=2015-09-10&returndate=2015-09-10&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "NK"
            ],
            Fare: 96.2
        },
        OriginLocation: "CLE",
        DepartureDateTime: "2015-09-09T00:00:00",
        ReturnDateTime: "2015-09-12T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=CLE&destination=DFW&departuredate=2015-09-09&returndate=2015-09-12&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA",
                "US"
            ],
            Fare: 120.6
        },
        OriginLocation: "PDX",
        DepartureDateTime: "2015-09-08T00:00:00",
        ReturnDateTime: "2015-09-08T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=PDX&destination=DFW&departuredate=2015-09-08&returndate=2015-09-08&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA",
                "US"
            ],
            Fare: 150.6
        },
        OriginLocation: "DCA",
        DepartureDateTime: "2015-09-23T00:00:00",
        ReturnDateTime: "2015-09-23T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=DCA&destination=DFW&departuredate=2015-09-23&returndate=2015-09-23&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA"
            ],
            Fare: 160.6
        },
        OriginLocation: "SLC",
        DepartureDateTime: "2015-09-23T00:00:00",
        ReturnDateTime: "2015-09-23T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=SLC&destination=DFW&departuredate=2015-09-23&returndate=2015-09-23&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "US"
            ],
            Fare: 166.6
        },
        OriginLocation: "MKE",
        DepartureDateTime: "2015-09-22T00:00:00",
        ReturnDateTime: "2015-09-22T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=MKE&destination=DFW&departuredate=2015-09-22&returndate=2015-09-22&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA"
            ],
            Fare: 179.1
        },
        OriginLocation: "CLT",
        DepartureDateTime: "2016-01-14T00:00:00",
        ReturnDateTime: "2016-01-14T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=CLT&destination=DFW&departuredate=2016-01-14&returndate=2016-01-14&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "DL"
            ],
            Fare: 179.6
        },
        OriginLocation: "BNA",
        DepartureDateTime: "2015-10-16T00:00:00",
        ReturnDateTime: "2015-10-16T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=BNA&destination=DFW&departuredate=2015-10-16&returndate=2015-10-16&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA"
            ],
            Fare: 180.6
        },
        OriginLocation: "STL",
        DepartureDateTime: "2015-11-16T00:00:00",
        ReturnDateTime: "2015-11-16T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=STL&destination=DFW&departuredate=2015-11-16&returndate=2015-11-16&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA"
            ],
            Fare: 190.6
        },
        OriginLocation: "CMH",
        DepartureDateTime: "2015-10-19T00:00:00",
        ReturnDateTime: "2015-10-19T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=CMH&destination=DFW&departuredate=2015-10-19&returndate=2015-10-19&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "UA",
                "AA"
            ],
            Fare: 192.7
        },
        OriginLocation: "PIT",
        DepartureDateTime: "2015-10-18T00:00:00",
        ReturnDateTime: "2015-10-24T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=PIT&destination=DFW&departuredate=2015-10-18&returndate=2015-10-24&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA"
            ],
            Fare: 196.2
        },
        OriginLocation: "IND",
        DepartureDateTime: "2015-09-16T00:00:00",
        ReturnDateTime: "2015-09-16T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=IND&destination=DFW&departuredate=2015-09-16&returndate=2015-09-16&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "AA"
            ],
            Fare: 202.6
        },
        OriginLocation: "SFO",
        DepartureDateTime: "2015-09-15T00:00:00",
        ReturnDateTime: "2015-09-15T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=SFO&destination=DFW&departuredate=2015-09-15&returndate=2015-09-15&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "US"
            ],
            Fare: 225.6
        },
        OriginLocation: "BDL",
        DepartureDateTime: "2015-09-23T00:00:00",
        ReturnDateTime: "2015-09-23T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=BDL&destination=DFW&departuredate=2015-09-23&returndate=2015-09-23&pointofsalecountry=US"
        }]
    }, {
        CurrencyCode: "USD",
        LowestFare: {
            AirlineCodes: [
                "UA"
            ],
            Fare: 239.1
        },
        OriginLocation: "SEA",
        DepartureDateTime: "2015-11-17T00:00:00",
        ReturnDateTime: "2015-11-17T00:00:00",
        Links: [{
            rel: "shop",
            href: "https://api.havail.sabre.com/v1/shop/flights?origin=SEA&destination=DFW&departuredate=2015-11-17&returndate=2015-11-17&pointofsalecountry=US"
        }]
    }],
    Links: [{
        rel: "self",
        href: "https://api.havail.sabre.com/v1/shop/flights/cheapest/fares/DFW"
    }, {
        rel: "linkTemplate",
        href: "https://api.havail.sabre.com/v1/shop/flights/cheapest/fares/<destination>?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 fare data specific to the Germany (DE) point of sale: pointofsalecountry=DE. The response will be fares eligible for sale in Germany.

InstaFlights Search API

The InstaFlights Search API retrieves roundtrip flight itineraries with published fares and fare breakdowns available from the Sabre® cache for a certain origin, destination, and roundtrip travel dates.

Errors

An HTTP status code is always returned. For information about the error response format, see the: Sabre APIs: common 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 origin or dates.

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

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

The origin or destination is not supported.

400 BAD REQUEST

Parameter 'pointofsalecountry' has an unsupported value

The value provided in pointofsalecountry is not a valid or supported country code. See also: point of sale.

Docs Navigation