Return list of Flight Offers based on posted searching criteria.

Request

Header Params

X-HTTP-Method-Override

string

required

the HTTP method to apply

Default:

GET

Body Params application/vnd.amadeus+json

currencyCode

string

optional

The currency code, as defined in ISO 4217, to reflect the currency in which this amount is expressed.

Example:

EUR

originDestinations

array[object (OriginDestination) {11}]

originDestinations

required

Origins and Destinations must be properly ordered in time (chronological order in accordance with the timezone of each location) to describe the journey consistently. Dates and times must not be past nor more than 365 days in the future, according to provider settings.Number of Origins and Destinations must not exceed the limit defined in provider settings.

>= 1 items<= 6 items

string

optional

Example:

originLocationCode

string

optional

Origin location, such as a city or an airport. Currently, only the locations defined in IATA are supported.

Example:

PAR

destinationLocationCode

string

optional

Destination location, such as a city or an airport. Currently, only the locations defined in IATA are supported.

Example:

NYC

includedConnectionPoints

array[string]

optional

List of included connections points. When an includedViaPoints option is specified, all FlightOffer returned must at least go via this Connecting Point. Currently, only the locations defined in IATA are supported. Used only by the AMADEUS provider

>= 1 items<= 2 items

Example:

["MRS"]

excludedConnectionPoints

array[string]

optional

List of excluded connections points. Any FlightOffer with these connections points will be present in response. Currently, only the locations defined in IATA are supported. Used only by the AMADEUS provider

>= 1 items<= 3 items

Example:

["MRS"]

originRadius

number

optional

Include other possible locations around the point, located less than this distance in kilometers away. Max:300

Can not be combined with "dateWindow" or "timeWindow".

Example:

200

alternativeOriginsCodes

array[string]

optional

Set of alternative origin location, such as a city or an airport. Currently, only the locations defined in IATA are supported.

>= 1 items<= 2 items

Example:

["LON","MUC"]

destinationRadius

number

optional

Include other possible locations around the point, located less than this distance in kilometers away. Max:300

Can not be combined with "dateWindow" or "timeWindow".

Example:

200

alternativeDestinationsCodes

array[string]

optional

Set of alternative destination location, such as a city or an airport. Currently, only the locations defined in IATA are supported.

>= 1 items<= 2 items

departureDateTimeRange

object

dateTimeRange

optional

arrivalDateTimeRange

object

dateTimeRange

optional

travelers

array[object (Extended_TravelerInfo) {3}]

travelers

required

travelers in the trip.

Maximum number of passengers older than 2 yo (CHILD, ADULT, YOUGHT): 9.
Each adult can travel with one INFANT so maximum total number of passengers: 18

>= 1 items<= 18 items

string

required

Example:

travelerType

enum<string>

TravelerType

required

traveler type
age restrictions : CHILD < 12y, HELD_INFANT < 2y, SEATED_INFANT < 2y, SENIOR >=60y

Allowed values:

ADULTCHILDSENIORYOUNGHELD_INFANTSEATED_INFANTSTUDENT

Example:

ADULT

associatedAdultId

string

optional

if type="HELD_INFANT", corresponds to the adult travelers's id who will share the seat

sources

array[string]

sources

required

Allows enable one or more sources. If present in the list, these sources will be called by the system.

>= 1 items

Allowed value:

GDS

searchCriteria

object (SearchCriteria)

optional

excludeAllotments

boolean

optional

This option allows to exclude the isAllotment flag associated to a booking class in the search response when it exist.

Example:

false

addOneWayOffers

boolean

optional

This option allows activate the one-way combinable feature

Example:

true

maxFlightOffers

number

optional

Maximum number of flight offers returned (Max 250)

Default:

250

Example:

250

maxPrice

integer

optional

maximum price per traveler. By default, no limit is applied. If specified, the value should be a positive number with no decimals

Example:

100

allowAlternativeFareOptions

boolean

optional

This option allows to default to a standard fareOption if no offers are found for the selected fareOption.

Example:

true

oneFlightOfferPerDay

boolean

optional

Requests the system to find at least one flight-offer per day, if possible, when a range of dates is specified. Default is false.

Example:

true

additionalInformation

object

AdditionalInformation

optional

pricingOptions

object (pricingOptions)

optional

fare filter options

flightFilters

object (FlightFilters)

optional

Example

{
    "currencyCode": "USD",
    "originDestinations": [
        {
            "id": "1",
            "originLocationCode": "NYC",
            "destinationLocationCode": "MAD",
            "departureDateTimeRange": {
                "date": "2023-11-01",
                "time": "10:00:00"
            }
        }
    ],
    "travelers": [
        {
            "id": "1",
            "travelerType": "ADULT"
        }
    ],
    "sources": [
        "GDS"
    ],
    "searchCriteria": {
        "maxFlightOffers": 2,
        "flightFilters": {
            "cabinRestrictions": [
                {
                    "cabin": "BUSINESS",
                    "coverage": "MOST_SEGMENTS",
                    "originDestinationIds": [
                        "1"
                    ]
                }
            ]
        }
    }
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Successful Operation

Return list of Flight Offers based on posted searching criteria.

Request

Request samples

Responses