Flight Low-Fare Search

GET

Flight Low-Fare Search

This is the low fare search engine Amadeus uses to retrieve the best price for flights, based on our latest Master Pricer Travel Board technology. This document describes how to make a low fare search and how to handle the returned messages.

The message is composed of multiple results for given request. A result is defined by a unique combination of price, tax, passenger type, fare type, cabin, and availability for each requested segment.

A result is then composed of single or multiple itineraries. Each itinerary is composed of an outbound leg, and, if a return date was specified, an inbound leg. Each leg is composed of a list of one or more flights, that the traveller will be required to take in order to get from the origin airport to the destination airport.

Resource URL

https://api.sandbox.amadeus.com/v1.2 /flights/low-fare-search

Query Parameters


Name Values Description
apikey
(required)

API Key provided for your account, to identify you for API access. Make sure to keep this API key secret.

origin
(required)

City code from which the traveler will depart. See the location and airport interfaces for more information.

destination
(required)

IATA code of the city to which the traveler is going

departure_date
(required)

The date on which the traveler will depart from the origin to go to the destination. You can specify a date range of up to 2 days. For a larger date range, use the Extensive Search. Dates are specified in the ISO 8601 yyyy-MM-dd date format and separated by --.

return_date

The date on which the traveler will depart from the destination to return to the origin. If this parameter is not specified, the search will find only one-way trips. If this, or the return_by parameter are specified, only return trips are found. You can specify a date range of up to 2 days.

arrive_by

The datetime by which the outbound flight should arrive, based on local time at the destination airport. Date-times are specified in the ISO 8601 yyyy-MM-ddTHH:mm date format

return_by

The time by which the inbound flight should arrive, based on local time at the airport specified as the origin parameter

adults

The number of adult (age 12 and over) passengers traveling on this flight.

children

The number of child (younger than age 12 on date of departure) passengers traveling on this flight who will each have their own separate seat

infants

The number of infant (younger than age 2 on date of departure) passengers traveling on this flight. Infants travel in the lap of an adult passenger, and thus the number of infants must not exceed the number of adults.

include_airlines

If specified, all results will include at least one flight where one or more of these airlines is the marketing carrier. This behaves as an OR function. Airlines are specified using IATA airline codes.

exclude_airlines

If specified, no results will include any flights where any of these airlines is the marketing carrier. Airlines are specified using IATA airline codes.

nonstop

Setting this to true will find only flights that do not require the passenger to change from one flight to another

max_price

Maximum price of trips to find in the result set, in USD (US dollars) unless some other currency code is specified. By default, no limit is applied

currency

The preferred currency for the results

travel_class

Searches for results where the majority of the itinerary flight time should be in a the specified cabin class or higher

number_of_results

The number of results to display. This will not be strictly interpreted but used as a guideline to display a useful number of results. By default, the number of results is dynamically determined. A maximum of 250 results will be displayed.


Request Body

Make a request and see the response.

Make a request and see the response.

Make a request and see the response.

Working...

 

Response format - Flight Low Fare Search

The response is returned as a JSON object with the following pieces of data:

Element Meaning Multiplicity
Root object
currency The ISO 4217 currency code that will be used for all prices in this response 1
results The array of search results 0..250
Result object
itineraries The number of potential flight itineraries in this response 0..250
fare The price and fare information which applies to all itineraries in this response 1
Itinerary object
outbound The bound container for the flight information for bringing the traveler from the origin airport to the destination airport 1
inbound The bound container for the flight information for bringing the traveler from the destination airport to the origin airport 0..1
Bound object
flights The ordered array of flight objects that comprise a single bound, to bring the traveler from one point to another 0..4
Flight object
departs_at Date and time of departure at the origin, in ISO 8601 date format yyyy-MM-ddTHH:mm in the local time at the origin airport 1
arrives_at Date and time of arrival at the destination, in ISO 8601 date format yyyy-MM-ddTHH:mm in the local time at the destination airport 1
origin Information on the origin airport, from which this flight departs 1
destination Information on the destination airport, at which this flight arrives 1
marketing_airline The 2 character alphanumeric IATA airline code of the airline that is responsible for the traveller this flight 1
operating_airline The 2 character alphanumeric IATA airline code of the airline that is providing the aircraft for this flight. Note that in the USA, if the marketing and operating carrier are different, you are legally required to display this in your application. 1
flight_number The identifier that the airline uses for this flight route. This is most commonly - but not always - a number. When combined with the airline and date, it identifies an individual aircraft's flight 1
aircraft The IATA aircraft type designator of aircraft that will be used for this flight 1
booking_info A booking information object with additional details about how the quality of this flight at the given price. 1
Airport object
airport >The 3 character IATA code of the airport in question for this flight 1
terminal >The terminal identifier at which this flight will arrive or depart in the given airport 0..1
Booking Information object
travel_class The cabin class offered on this flight. An enumeration that will read either ECONOMY, PREMIUM_ECONOMY, BUSINESS or FIRST 1
booking_code The Reservation Booking Designator code that determines the quality and terms of the flight offered for the given price. A single letter from A..Z 1
seats_remaining The minimum number of seats that are still available for this price at the time of search. If the value is a 4 or above, there are often more than this number of seats still available. 1
Price object
total_price The total price for all the requested passengers for this flight as a String 1
price_per_adult The per-passenger fare for each adult on this flight 1
price_per_child The per-passenger fare for each child on this flight 0..1
price_per_infant The per-passenger fare for each infant on this flight 0..1
restrictions The limitations that are associated with this fare 1
Fare object
total_fare The total price, including taxes per-passenger, for this passenger type, for this itinerary. Always a string, formatted correctly for the given currency 1
tax The tax applied per-passenger, for this passenger type, for this itinerary. Some of this tax may be refundable in the event of cancellation. 1
Restrictions object
refundable Boolean which denotes whether, in the event that the passenger wishes to cancel the flight, any of the monies paid would be returned. 1
change_penalties Boolean which denotes whether a monetary penalty applies, in the event that the passenger wishes to change the dates of any leg of the flight 1
 

Examples

Simple two-way, Istanbul to Boston, outbound flight departing Istanbul for Boston on October 15th, return flight departing Boston for Istanbul on October 21st, for one adult, best 3 results only.

Request

http://api.sandbox.amadeus.com/v1.2/flights/low-fare-search?origin=IST&destination=BOS&departure_date=2015-10-15&return_date=2015-10-21&number_of_results=3&apikey=<your API key>

Response

{
	"currency": "USD",
	"results": [
		{
			"itineraries": [
				{
					"outbound": {
						"flights": [
							{
								"departs_at": "2015-10-15T06:15",
								"arrives_at": "2015-10-15T08:55",
								"origin": {
									"airport": "IST",
									"terminal": "I"
								},
								"destination": {
									"airport": "CDG",
									"terminal": "2E"
								},
								"marketing_airline": "AF",
								"operating_airline": "AF",
								"flight_number": "1391",
								"aircraft": "319",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "L",
									"seats_remaining": 9
								}
							}, {
								"departs_at": "2015-10-15T10:35",
								"arrives_at": "2015-10-15T12:46",
								"origin": {
									"airport": "CDG",
									"terminal": "2E"
								},
								"destination": {
									"airport": "BOS",
									"terminal": "E"
								},
								"marketing_airline": "AF",
								"operating_airline": "DL",
								"flight_number": "3616",
								"aircraft": "75W",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "R",
									"seats_remaining": 9
								}
							}
						]
					},
					"inbound": {
						"flights": [
							{
								"departs_at": "2015-10-21T19:25",
								"arrives_at": "2015-10-22T08:35",
								"origin": {
									"airport": "BOS",
									"terminal": "A"
								},
								"destination": {
									"airport": "CDG",
									"terminal": "2E"
								},
								"marketing_airline": "AF",
								"operating_airline": "DL",
								"flight_number": "3655",
								"aircraft": "75W",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "R",
									"seats_remaining": 6
								}
							}, {
								"departs_at": "2015-10-22T10:00",
								"arrives_at": "2015-10-22T14:20",
								"origin": {
									"airport": "CDG",
									"terminal": "2E"
								},
								"destination": {
									"airport": "IST",
									"terminal": "I"
								},
								"marketing_airline": "AF",
								"operating_airline": "AF",
								"flight_number": "1590",
								"aircraft": "319",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "L",
									"seats_remaining": 9
								}
							}
						]
					}
				}
			],
			"fare": {
				"total_price": "528.30",
				"price_per_adult": {
					"total_fare": "528.30",
					"tax": "340.30"
				},
				"restrictions": {
					"refundable": false,
					"change_penalties": true
				}
			}
		}, {
			"itineraries": [
				{
					"outbound": {
						"flights": [
							{
								"departs_at": "2015-10-15T06:00",
								"arrives_at": "2015-10-15T08:30",
								"origin": {
									"airport": "IST",
									"terminal": "I"
								},
								"destination": {
									"airport": "AMS"
								},
								"marketing_airline": "KL",
								"operating_airline": "KL",
								"flight_number": "1610",
								"aircraft": "73H",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "L",
									"seats_remaining": 9
								}
							}, {
								"departs_at": "2015-10-15T10:35",
								"arrives_at": "2015-10-15T12:38",
								"origin": {
									"airport": "AMS"
								},
								"destination": {
									"airport": "BOS",
									"terminal": "E"
								},
								"marketing_airline": "KL",
								"operating_airline": "DL",
								"flight_number": "6031",
								"aircraft": "333",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "R",
									"seats_remaining": 9
								}
							}
						]
					},
					"inbound": {
						"flights": [
							{
								"departs_at": "2015-10-21T21:29",
								"arrives_at": "2015-10-22T10:30",
								"origin": {
									"airport": "BOS",
									"terminal": "A"
								},
								"destination": {
									"airport": "AMS"
								},
								"marketing_airline": "KL",
								"operating_airline": "DL",
								"flight_number": "6016",
								"aircraft": "764",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "R",
									"seats_remaining": 9
								}
							}, {
								"departs_at": "2015-10-22T11:25",
								"arrives_at": "2015-10-22T15:45",
								"origin": {
									"airport": "AMS"
								},
								"destination": {
									"airport": "IST",
									"terminal": "I"
								},
								"marketing_airline": "KL",
								"operating_airline": "KL",
								"flight_number": "1613",
								"aircraft": "73H",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "L",
									"seats_remaining": 9
								}
							}
						]
					}
				}
			],
			"fare": {
				"total_price": "530.98",
				"price_per_adult": {
					"total_fare": "530.98",
					"tax": "342.98"
				},
				"restrictions": {
					"refundable": false,
					"change_penalties": true
				}
			}
		}, {
			"itineraries": [
				{
					"outbound": {
						"flights": [
							{
								"departs_at": "2015-10-15T13:25",
								"arrives_at": "2015-10-15T17:00",
								"origin": {
									"airport": "IST",
									"terminal": "I"
								},
								"destination": {
									"airport": "BOS",
									"terminal": "E"
								},
								"marketing_airline": "TK",
								"operating_airline": "TK",
								"flight_number": "81",
								"aircraft": "343",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "P",
									"seats_remaining": 9
								}
							}
						]
					},
					"inbound": {
						"flights": [
							{
								"departs_at": "2015-10-21T23:45",
								"arrives_at": "2015-10-22T16:25",
								"origin": {
									"airport": "BOS",
									"terminal": "E"
								},
								"destination": {
									"airport": "IST",
									"terminal": "I"
								},
								"marketing_airline": "TK",
								"operating_airline": "TK",
								"flight_number": "82",
								"aircraft": "343",
								"booking_info": {
									"travel_class": "ECONOMY",
									"booking_code": "P",
									"seats_remaining": 9
								}
							}
						]
					}
				}
			],
			"fare": {
				"total_price": "655.00",
				"price_per_adult": {
					"total_fare": "655.00",
					"tax": "344.00"
				},
				"restrictions": {
					"refundable": false,
					"change_penalties": true
				}
			}
		}
	]
}

Return flight for 2 adults, 3 children and an infant, direct from Istanbul to Boston on October 15th, direct from Boston to Istanbul arriving no later than October 21st at 20:00, preferring Turkish Airlines

Request

http://api.sandbox.amadeus.com/v1.2/flights/low-fare-search?origin=IST&destination=BOS&departure_date=2015-10-15&return_by=2015-10-21T20:00&adults=2&children=3&infants=1&direct=true&include_airlines=TK&apikey=<your API key>

Response

{
  "currency" : "USD",
  "results" : [ {
    "itineraries" : [ {
      "outbound" : {
        "flights" : [ {
          "departs_at" : "2015-10-15T13:25",
          "arrives_at" : "2015-10-15T17:00",
          "origin" : {
            "airport" : "IST",
            "terminal" : "I"
          },
          "destination" : {
            "airport" : "BOS",
            "terminal" : "E"
          },
          "marketing_airline" : "TK",
          "operating_airline" : "TK",
          "flight_number" : "81",
          "aircraft" : "343",
          "booking_info" : {
            "travel_class" : "ECONOMY",
            "booking_code" : "P",
            "seats_remaining" : 9
          }
        } ]
      },
      "inbound" : {
        "flights" : [ {
          "departs_at" : "2015-10-20T23:45",
          "arrives_at" : "2015-10-21T16:25",
          "origin" : {
            "airport" : "BOS",
            "terminal" : "E"
          },
          "destination" : {
            "airport" : "IST",
            "terminal" : "I"
          },
          "marketing_airline" : "TK",
          "operating_airline" : "TK",
          "flight_number" : "82",
          "aircraft" : "343",
          "booking_info" : {
            "travel_class" : "ECONOMY",
            "booking_code" : "P",
            "seats_remaining" : 9
          }
        } ]
      }
    } ],
    "fare" : {
      "total_price" : "3133.50",
      "price_per_adult" : {
        "total_fare" : "655.00",
        "tax" : "344.00"
      },
      "price_per_child" : {
        "total_fare" : "578.00",
        "tax" : "344.00"
      },
      "price_per_infant" : {
        "total_fare" : "89.50",
        "tax" : "58.50"
      },
      "restrictions" : {
        "refundable" : false,
        "change_penalties" : true
      }
    }
  } ]
}