Flight Offers Search API

Learn to search for the best flight deals for a trip.

The Flight Offers Search API allows us to search for the best flight deals for our trips. It provides the cheapest flights from more than 500 airlines for our trip itineraries. We can search for flights across two or more cities based on our trip itinerary and duration. This API provides detailed information for each proposed flight, including the airline name for the flight, price, and other important flight information.

Get flight offers

We'll use the following URL to search for the best flight offers for a given itinerary:

Press + to interact
https://test.api.amadeus.com/v2/shopping/flight-offers

Request parameters

Parameter

Type

Category

Description

ACCESS_TOKEN

string

required

Our unique access token

originLocationCode

string

required

The IATA code for the passenger's departure city/airport

Note: Refer to the appendix for the city/airport codes.

destinationLocationCode

string

required

The IATA code for the passenger's destination city/airport

Note: Refer to the appendix for the city/airport codes.

departureDate

string

required

The date of departure

Format: YYYY-MM-DD

adults

integer

required

The number of adults (12 years or older); default value is 1

returnDate

string

optional

The date of return

Note: If this parameter is not specified, a one-way itinerary is returned.

Format: YYYY-MM-DD

children

integer

optional

The number of children (2 to 12 years old)

infants

integer

optional

The number of infants (up to 2 years old)

travelClass

string

optional

This specifies the cabin type where the passenger will spend the majority of the flight time. Its available values are ECONOMY, PREMIUM_ECONOMY, BUSINESS, and FIRST.

includedAirlineCodes

string

optional

A comma-separated list of 2 to 3-character airline codes to include

Note: Refer to the appendix for the airline codes.

excludedAirlineCodes

string

optional

A comma-separated list of 2 to 3-character airline codes to exclude

Note: Refer to the appendix for the airline codes.

nonStop

boolean

optional

If no stopovers the value is true else, value is false

currencyCode

string

optional

A 3-character code of preferred currency for flight offers

Note: Refer to the appendix for the currency codes.

maxPrice

integer

optional

The maximum price per passenger

max

integer

optional

The maximum number of flight offers to retrieve; default value is 250

In ...