Flight Offers Search
POST https://test.api.amadeus.com/v2/shopping/flight-offers
The Flight Offers Search API allows to get cheapest flight recommendations and prices on a given journey. It provides a list of flight recommendations and fares from a given origin (city or airport), for a given date (or date range) and for a given list of passengers. Additional information such as bag allowance, first ancillary bag prices or fare details are also provided.
Request Body
{"currencyCode"=>"USD", "originDestinations"=>[{"id"=>"1", "originLocationCode"=>"BOS", "destinationLocationCode"=>"MAD", "departureDateTimeRange"=>{"date"=>"{{departureDate}}", "time"=>"10:00:00"}}, {"id"=>"2", "originLocationCode"=>"MAD", "destinationLocationCode"=>"BOS", "departureDateTimeRange"=>{"date"=>"{{returnDate}}", "time"=>"17:00:00"}}], "travelers"=>[{"id"=>"1", "travelerType"=>"ADULT", "fareOptions"=>["STANDARD"]}, {"id"=>"2", "travelerType"=>"CHILD", "fareOptions"=>["STANDARD"]}], "sources"=>["GDS"], "searchCriteria"=>{"maxFlightOffers"=>2, "flightFilters"=>{"cabinRestrictions"=>[{"cabin"=>"BUSINESS", "coverage"=>"MOST_SEGMENTS", "originDestinationIds"=>["1"]}], "carrierRestrictions"=>{"excludedCarrierCodes"=>["AA", "TP", "AZ"]}}}}
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Content-Type | string | ||
X-HTTP-Method-Override | string |
RESPONSES
status: OK
{"meta":{"count":2},"data":[{"type":"flight-offer","id":"1","source":"GDS","instantTicketingRequired":false,"nonHomogeneous":false,"oneWay":false,"lastTicketingDate":"2024-03-21","lastTicketingDateTime":"2024-03-21","numberOfBookableSeats":9,"itineraries":[{"duration":"PT7H","segments":[{"departure":{"iataCode":"BOS","terminal":"E","at":"2024-04-04T17:00:00"},"arrival":{"iataCode":"MAD","terminal":"4S","at":"2024-04-05T06:00:00"},"carrierCode":"IB","number":"6166","aircraft":{"code":"330"},"operating":{"carrierCode":"IB"},"duration":"PT7H","id":"1","numberOfStops":0,"blacklistedInEU":false}]},{"duration":"PT29H5M","segments":[{"departure":{"iataCode":"MAD","terminal":"4S","at":"2024-04-18T20:45:00"},"arrival":{"iataCode":"LHR","terminal":"5","at":"2024-04-18T22:00:00"},"carrierCode":"IB","number":"7467","aircraft":{"code":"319"},"operating":{"carrierCode":"BA"},"duration":"PT2H15M","id":"4","numberOfStops":0,"blacklistedInEU":false},{"departure":{"iataCode":"LHR","terminal":"5","at":"2024-04-19T17:15:00"},"arrival":{"iataCode":"BOS","terminal":"E","at":"2024-04-19T19:50:00"},"carrierCode":"AY","number":"5503","aircraft":{"code":"781"},"operating":{"carrierCode":"BA"},"duration":"PT7H35M","id":"5","numberOfStops":0,"blacklistedInEU":false}]}],"price":{"currency":"USD","total":"6502.20","base":"3898.00","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"grandTotal":"6502.20"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":false},"validatingAirlineCodes":["IB"],"travelerPricings":[{"travelerId":"1","fareOption":"STANDARD","travelerType":"ADULT","price":{"currency":"USD","total":"3251.10","base":"1949.00"},"fareDetailsBySegment":[{"segmentId":"1","cabin":"BUSINESS","fareBasis":"INX4A3S5","brandedFare":"BUSOPTIMA","brandedFareLabel":"BUSINESS OPTIMA","class":"I","includedCheckedBags":{"quantity":2},"amenities":[{"description":"THIRD CHECKED BAG","isChargeable":true,"amenityType":"BAGGAGE","amenityProvider":{"name":"BrandedFare"}},{"description":"MEAL","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"SNACK OR DRINK","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"PRIORITY CHECK IN","isChargeable":false,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}},{"description":"WIFI CONNECTION","isChargeable":true,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}},{"description":"PRIORITY BOARDING GROUP 1","isChargeable":false,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"4","cabin":"BUSINESS","fareBasis":"INX4A3S5","class":"J","includedCheckedBags":{"quantity":1}},{"segmentId":"5","cabin":"ECONOMY","fareBasis":"LLX4F0M5","class":"L","includedCheckedBags":{"quantity":1}}]},{"travelerId":"2","fareOption":"STANDARD","travelerType":"CHILD","price":{"currency":"USD","total":"3251.10","base":"1949.00"},"fareDetailsBySegment":[{"segmentId":"1","cabin":"BUSINESS","fareBasis":"INX4A3S5","brandedFare":"BUSOPTIMA","brandedFareLabel":"BUSINESS OPTIMA","class":"I","amenities":[{"description":"THIRD CHECKED BAG","isChargeable":true,"amenityType":"BAGGAGE","amenityProvider":{"name":"BrandedFare"}},{"description":"MEAL","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"SNACK OR DRINK","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"PRIORITY CHECK IN","isChargeable":false,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}},{"description":"WIFI CONNECTION","isChargeable":true,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}},{"description":"PRIORITY BOARDING GROUP 1","isChargeable":false,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"4","cabin":"BUSINESS","fareBasis":"INX4A3S5","class":"J"},{"segmentId":"5","cabin":"ECONOMY","fareBasis":"LLX4F0M5","class":"L"}]}]},{"type":"flight-offer","id":"2","source":"GDS","instantTicketingRequired":false,"nonHomogeneous":false,"oneWay":false,"lastTicketingDate":"2024-03-21","lastTicketingDateTime":"2024-03-21","numberOfBookableSeats":9,"itineraries":[{"duration":"PT11H40M","segments":[{"departure":{"iataCode":"BOS","terminal":"B","at":"2024-04-04T16:40:00"},"arrival":{"iataCode":"YYZ","terminal":"1","at":"2024-04-04T18:43:00"},"carrierCode":"AC","number":"8699","aircraft":{"code":"E75"},"duration":"PT2H3M","id":"2","numberOfStops":0,"blacklistedInEU":false},{"departure":{"iataCode":"YYZ","terminal":"1","at":"2024-04-04T20:55:00"},"arrival":{"iataCode":"MAD","terminal":"1","at":"2024-04-05T10:20:00"},"carrierCode":"AC","number":"824","aircraft":{"code":"788"},"operating":{"carrierCode":"AC"},"duration":"PT7H25M","id":"3","numberOfStops":0,"blacklistedInEU":false}]},{"duration":"PT23H23M","segments":[{"departure":{"iataCode":"MAD","terminal":"2","at":"2024-04-18T21:15:00"},"arrival":{"iataCode":"BRU","at":"2024-04-18T23:25:00"},"carrierCode":"SN","number":"3730","aircraft":{"code":"319"},"operating":{"carrierCode":"SN"},"duration":"PT2H10M","id":"6","numberOfStops":0,"blacklistedInEU":false},{"departure":{"iataCode":"BRU","at":"2024-04-19T10:00:00"},"arrival":{"iataCode":"YUL","at":"2024-04-19T11:30:00"},"carrierCode":"SN","number":"9551","aircraft":{"code":"77W"},"operating":{"carrierCode":"AC"},"duration":"PT7H30M","id":"7","numberOfStops":0,"blacklistedInEU":false},{"departure":{"iataCode":"YUL","at":"2024-04-19T13:10:00"},"arrival":{"iataCode":"BOS","terminal":"B","at":"2024-04-19T14:38:00"},"carrierCode":"SN","number":"9617","aircraft":{"code":"E75"},"duration":"PT1H28M","id":"8","numberOfStops":0,"blacklistedInEU":false}]}],"price":{"currency":"USD","total":"6846.40","base":"4180.00","fees":[{"amount":"0.00","type":"SUPPLIER"},{"amount":"0.00","type":"TICKETING"}],"grandTotal":"6846.40"},"pricingOptions":{"fareType":["PUBLISHED"],"includedCheckedBagsOnly":false},"validatingAirlineCodes":["AC"],"travelerPricings":[{"travelerId":"1","fareOption":"STANDARD","travelerType":"ADULT","price":{"currency":"USD","total":"3423.20","base":"2090.00"},"fareDetailsBySegment":[{"segmentId":"2","cabin":"BUSINESS","fareBasis":"ZNX49ENC","brandedFare":"EXECLOW","brandedFareLabel":"BUSINESS LOWEST","class":"Z","includedCheckedBags":{"quantity":2},"amenities":[{"description":"COMPLIMENTARY MEAL","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"PRIORITY CHECK IN","isChargeable":false,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}},{"description":"BASIC SEAT","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"CHANGEABLE TICKET","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREMIUM SEAT","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"3","cabin":"BUSINESS","fareBasis":"ZNX49ENC","brandedFare":"EXECLOW","brandedFareLabel":"BUSINESS LOWEST","class":"Z","includedCheckedBags":{"quantity":2},"amenities":[{"description":"COMPLIMENTARY MEAL","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"PRIORITY CHECK IN","isChargeable":false,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}},{"description":"BASIC SEAT","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"CHANGEABLE TICKET","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREMIUM SEAT","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"6","cabin":"ECONOMY","fareBasis":"KKX76NCT","brandedFare":"ECOSTAND","brandedFareLabel":"ECO STANDARD","class":"K","includedCheckedBags":{"quantity":1},"amenities":[{"description":"CATERING ON EUROPE FLTS","isChargeable":true,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"CATERING ON INTERCONT FLTS","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"STANDARD SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"MILEAGE ACCRUAL","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"UPGRADE ELIGIBILITY","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREFERRED SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"INFLIGHT ENTERTAINMENT","isChargeable":false,"amenityType":"ENTERTAINMENT","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"7","cabin":"ECONOMY","fareBasis":"KKX76NCT","brandedFare":"ECOSTAND","brandedFareLabel":"ECO STANDARD","class":"K","includedCheckedBags":{"quantity":1},"amenities":[{"description":"CATERING ON EUROPE FLTS","isChargeable":true,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"CATERING ON INTERCONT FLTS","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"STANDARD SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"MILEAGE ACCRUAL","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"UPGRADE ELIGIBILITY","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREFERRED SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"INFLIGHT ENTERTAINMENT","isChargeable":false,"amenityType":"ENTERTAINMENT","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"8","cabin":"ECONOMY","fareBasis":"KKX76NCT","brandedFare":"ECOSTAND","brandedFareLabel":"ECO STANDARD","class":"K","includedCheckedBags":{"quantity":1},"amenities":[{"description":"CATERING ON EUROPE FLTS","isChargeable":true,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"CATERING ON INTERCONT FLTS","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"STANDARD SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"MILEAGE ACCRUAL","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"UPGRADE ELIGIBILITY","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREFERRED SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"INFLIGHT ENTERTAINMENT","isChargeable":false,"amenityType":"ENTERTAINMENT","amenityProvider":{"name":"BrandedFare"}}]}]},{"travelerId":"2","fareOption":"STANDARD","travelerType":"CHILD","price":{"currency":"USD","total":"3423.20","base":"2090.00"},"fareDetailsBySegment":[{"segmentId":"2","cabin":"BUSINESS","fareBasis":"ZNX49ENC","brandedFare":"EXECLOW","brandedFareLabel":"BUSINESS LOWEST","class":"Z","amenities":[{"description":"COMPLIMENTARY MEAL","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"PRIORITY CHECK IN","isChargeable":false,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}},{"description":"BASIC SEAT","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"CHANGEABLE TICKET","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREMIUM SEAT","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"3","cabin":"BUSINESS","fareBasis":"ZNX49ENC","brandedFare":"EXECLOW","brandedFareLabel":"BUSINESS LOWEST","class":"Z","amenities":[{"description":"COMPLIMENTARY MEAL","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"PRIORITY CHECK IN","isChargeable":false,"amenityType":"TRAVEL_SERVICES","amenityProvider":{"name":"BrandedFare"}},{"description":"BASIC SEAT","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"CHANGEABLE TICKET","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREMIUM SEAT","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"6","cabin":"ECONOMY","fareBasis":"KKX76NCT","brandedFare":"ECOSTAND","brandedFareLabel":"ECO STANDARD","class":"K","amenities":[{"description":"CATERING ON EUROPE FLTS","isChargeable":true,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"CATERING ON INTERCONT FLTS","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"STANDARD SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"MILEAGE ACCRUAL","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"UPGRADE ELIGIBILITY","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREFERRED SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"INFLIGHT ENTERTAINMENT","isChargeable":false,"amenityType":"ENTERTAINMENT","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"7","cabin":"ECONOMY","fareBasis":"KKX76NCT","brandedFare":"ECOSTAND","brandedFareLabel":"ECO STANDARD","class":"K","amenities":[{"description":"CATERING ON EUROPE FLTS","isChargeable":true,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"CATERING ON INTERCONT FLTS","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"STANDARD SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"MILEAGE ACCRUAL","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"UPGRADE ELIGIBILITY","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREFERRED SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"INFLIGHT ENTERTAINMENT","isChargeable":false,"amenityType":"ENTERTAINMENT","amenityProvider":{"name":"BrandedFare"}}]},{"segmentId":"8","cabin":"ECONOMY","fareBasis":"KKX76NCT","brandedFare":"ECOSTAND","brandedFareLabel":"ECO STANDARD","class":"K","amenities":[{"description":"CATERING ON EUROPE FLTS","isChargeable":true,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"CATERING ON INTERCONT FLTS","isChargeable":false,"amenityType":"MEAL","amenityProvider":{"name":"BrandedFare"}},{"description":"STANDARD SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"MILEAGE ACCRUAL","isChargeable":false,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"UPGRADE ELIGIBILITY","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"PREFERRED SEAT RESERVATION","isChargeable":true,"amenityType":"BRANDED_FARES","amenityProvider":{"name":"BrandedFare"}},{"description":"INFLIGHT ENTERTAINMENT","isChargeable":false,"amenityType":"ENTERTAINMENT","amenityProvider":{"name":"BrandedFare"}}]}]}]}],"dictionaries":{"locations":{"MAD":{"cityCode":"MAD","countryCode":"ES"},"YUL":{"cityCode":"YMQ","countryCode":"CA"},"BRU":{"cityCode":"BRU","countryCode":"BE"},"BOS":{"cityCode":"BOS","countryCode":"US"},"LHR":{"cityCode":"LON","countryCode":"GB"},"YYZ":{"cityCode":"YTO","countryCode":"CA"}},"aircraft":{"319":"AIRBUS A319","330":"AIRBUS INDUSTRIE A330","781":"BOEING 787-10","788":"BOEING 787-8","E75":"EMBRAER 175","77W":"BOEING 777-300ER"},"currencies":{"USD":"US DOLLAR"},"carriers":{"AC":"AIR CANADA","AY":"FINNAIR","IB":"IBERIA","SN":"BRUSSELS AIRLINES","BA":"BRITISH AIRWAYS"}}}