Return list of Flight Offers based on searching criteria.

GET

/shopping/flight-offers

Shopping

Request

Query Params

originLocationCode

string

required

city/airport IATA code from which the traveler will depart, e.g. BOS for Boston

Example:

SYD

Match pattern:

[A-Z]{3}

destinationLocationCode

string

required

city/airport IATA code to which the traveler is going, e.g. PAR for Paris

Example:

BKK

Match pattern:

[A-Z]{3}

departureDate

string <date>

required

the date on which the traveler will depart from the origin to go to the destination. Dates are specified in the ISO 8601 YYYY-MM-DD format, e.g. 2017-12-25

Example:

2023-05-02

returnDate

string <date>

optional

the date on which the traveler will depart from the destination to return to the origin. If this parameter is not specified, only one-way itineraries are found. If this parameter is specified, only round-trip itineraries are found. Dates are specified in the ISO 8601 YYYY-MM-DD format, e.g. 2018-02-28

adults

integer

required

the number of adult travelers (age 12 or older on date of departure).

The total number of seated travelers (adult and children) can not exceed 9.

>= 1<= 9

Default:

children

integer

optional

the number of child travelers (older than age 2 and younger than age 12 on date of departure) who will each have their own separate seat. If specified, this number should be greater than or equal to 0

The total number of seated travelers (adult and children) can not exceed 9.

>= 0<= 9

infants

integer

optional

the number of infant travelers (whose age is less or equal to 2 on date of departure). Infants travel on the lap of an adult traveler, and thus the number of infants must not exceed the number of adults. If specified, this number should be greater than or equal to 0

>= 0<= 9

travelClass

enum<string>

optional

most of the flight time should be spent in a cabin of this quality or higher. The accepted travel class is economy, premium economy, business or first class. If no travel class is specified, the search considers any travel class

Allowed values:

ECONOMYPREMIUM_ECONOMYBUSINESSFIRST

includedAirlineCodes

string

optional

This option ensures that the system will only consider these airlines. This can not be cumulated with parameter excludedAirlineCodes.

Airlines are specified as IATA airline codes and are comma-separated, e.g. 6X,7X,8X

Match pattern:

[0-9A-Z]{2}

excludedAirlineCodes

string

optional

This option ensures that the system will ignore these airlines. This can not be cumulated with parameter includedAirlineCodes.

Airlines are specified as IATA airline codes and are comma-separated, e.g. 6X,7X,8X

Match pattern:

[0-9A-Z]{2}

nonStop

boolean

optional

if set to true, the search will find only flights going from the origin to the destination with no stop in between

Default:

false

currencyCode

string

optional

the preferred currency for the flight offers. Currency is specified in the ISO 4217 format, e.g. EUR for Euro

Match pattern:

[A-Z]{3}

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

>= 1

max

integer

optional

maximum number of flight offers to return. If specified, the value should be greater than or equal to 1

>= 1

Default:

250

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET '/shopping/flight-offers?originLocationCode=SYD&destinationLocationCode=BKK&departureDate=2023-05-02&adults'

Responses

🟢200OK

application/vnd.amadeus+json

Successful Operation

Body

object {0}

Example

{}

🟠400Bad Request

🔴500Server Error

Return list of Flight Offers based on posted searching criteria.

Access Granted Client Credentials