Flights Parameters

Page Type	Description	Landing Page
home	Skyscanner Home	Link
day-view	Flights Day View	Link
calendar-month-view	Flights Month View	Link
browse-view	Flights Browse View	Link
multicity	Flights Multi-City	Link
cheap-flights-to	Cheap Flights To	Link
flights-airline	Flights Airline	Link

For more details on the supported verticals and page types, please visit Verticals and Page Types.

Flights Home Page Schema

/flights/home

A schema definition for the flights home page microsite supported parameters.

Flights Home Page Properties

Property	Type	Required
market	string	Optional
locale	string	Optional
currency	string	Optional

market

The preferred market for searching results.

When unspecified, we use detection logic to determine the market, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. UK, US, FR

locale

The preferred locale for the desired page.

When unspecified, we use detection logic to determine the locale, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. es-ES, en-GB, fr-FR

currency

The preferred currency for the desired page.

When unspecified, we use detection logic to determine the currency, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. GBP, EUR, USD

Flights Day View Schema

/flights/day-view

A schema definition for the flights day-view microsite supported parameters.

Flights Day View Properties

Property	Type	Required
origin	string	Required
destination	string	Required
outboundDate	string	Required
inboundDate	string	Optional
adultsv2	integer	Optional
childrenv2	string	Optional
cabinclass	string	Required
preferDirects	boolean	Optional
outboundaltsenabled	boolean	Optional
inboundaltsenabled	boolean	Optional
market	string	Optional
locale	string	Optional
currency	string	Optional
sortby	string	Optional
airlines	string	Optional
alliances	string	Optional
departure-times	string	Optional
duration	integer	Optional

origin

IATA code for the origin. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Required	string	e.g. EDI, BCN, LIS

destination

IATA code for the destination. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Required	string	e.g. EDI, BCN, LIS

outboundDate

Required	Type	Format
Required	string	YYYY-MM-DD

inboundDate

Required	Type	Format
Optional	string	YYYY-MM-DD

adultsv2

Number of adult passengers. Adults have to be 18 years old or older.

Required	Type	Format	Default value
Optional	integer	e.g. 2	1

childrenv2

Number of children passengers. Child age has to be in the 2-17 range. The value must be in the format integer|integer... where each number is the age of the child passenger.

Required	Type	Format
Optional	string	e.g. 3|4|5

cabinclass

Cabin class for the flight.

Required	Type	Default value
Optional	enum	economy

The value of this property must be equal to one of the following values:

ENUM values
economy
premiumeconomy
business
first

preferDirects

When this parameter is set to true, only direct flights results will be shown.

Required	Type	Format
Optional	boolean	e.g. false

outboundaltsenabled

When this parameter is set to true, the results will include nearby airports as an outbound place.

Required	Type	Format
Optional	boolean	e.g. false

inboundaltsenabled

When this parameter is set to true, the results will include nearby airports as an inbound place.

Required	Type	Format
Optional	boolean	e.g. false

market

The preferred market for searching results.

When unspecified, we use detection logic to determine the market, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. UK, US, FR

locale

The preferred locale for the desired page.

When unspecified, we use detection logic to determine the locale, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. es-ES, en-GB, fr-FR

currency

The preferred currency for the desired page.

When unspecified, we use detection logic to determine the currency, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. GBP, EUR, USD

The preferred currency for the desired page.

Required	Type	Format
Optional	string	e.g. GBP, EUR, USD

sortby

Sets the sorting order for the results. If not specified, results will be sorted by best.
Learn more

Required	Type
Optional	enum

The value of this property must be equal to one of the following values:

ENUM values	Explanation
cheapest	Sorts the results by price from cheapest to most expensive.
fastest	Sort the results by the flight duration from fastest to longest.

airlines

Comma separated list of IATA/ICAO airline codes to be passed to the day-view filters.

Required	Type	Format
Optional	string	e.g. AF,EZY,TK

alliances

Comma separated list of alliance names passed to the day-view filters.

Required	Type	Format	Supported values
Optional	string	e.g. OneWorld,SkyTeam	OneWorld, Star Alliance, SkyTeam and Value Alliance

departure-times

Sets the day-view departure time filters in minutes.

Required	Type	Format
Optional	string	e.g. 00-90,30-990 (first leg departs between 00 and 1:30, second departs between 00:30 and 16:30)

duration

Sets the day-view duration filters in minutes.

Required	Type	Format
Optional	integer	e.g. 1320 (22 hours)

Flights Browse View Schema

/flights/browse-view

A schema definition for the flights browse view microsite supported parameters.

Flights Browse View Properties

Property	Type	Required
origin	string	Required
destination	string	Optional
outboundDate	string	Optional
inboundDate	string	Optional
adultsv2	integer	Optional
childrenv2	string	Optional
oym	string	Optional
iym	string	Optional
rtn	string	Optional
preferDirects	boolean	Optional
market	string	Optional
locale	string	Optional
currency	string	Optional

origin

Country or IATA code for the origin.

IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Required	string	e.g. UK, LHR

destination

Country or IATA code for the destination.

IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. UK, LHR

outboundDate

Required	Type	Format
Optional	string	YYYY-MM-DD

inboundDate

Required	Type	Format
Optional	string	YYYY-MM-DD

adultsv2

Number of adult passengers. Adults have to be 18 years old or older.

Required	Type	Format	Default value
Optional	integer	e.g. 2	1

childrenv2

Number of children passengers. Child age has to be in the 2-17 range. The value must be in the format integer|integer... where each number is the age of the child passenger.

Required	Type	Format
Optional	string	e.g. 3|4|5

oym

Outbound month.

Required	Type	Format
Optional	string	YYYY-MM

iym

Inbound month.

Can only be used in combination with oym.

Required	Type	Format
Optional	string	YYYY-MM

rtn

Trip type.

Required	Type
Optional	enum

The value of this property must be equal to one of the following values:

Value	Explanation
0	if oneway trip
1	if return or multicity trip

preferDirects

When this parameter is set to true, only direct flights results will be shown.

Required	Type	Format
Optional	boolean	false

market

The preferred market for searching results.

When unspecified, we use detection logic to determine the market, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. UK, US, FR

locale

The preferred locale for the desired page.

When unspecified, we use detection logic to determine the locale, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. es-ES, en-GB, fr-FR

currency

The preferred currency for the desired page.

When unspecified, we use detection logic to determine the currency, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. GBP, EUR, USD

Flights Calendar Month View Schema

/flights/calendar-month-view

A schema definition for the flights calendar month view microsite supported parameters.

Flights Calendar Month View Properties

Property	Type	Required
origin	string	Required
destination	string	Required
oym	string	Optional
iym	string	Optional
adultsv2	integer	Optional
childrenv2	string	Optional
rtn	string	Optional
preferDirects	boolean	Optional
selectedoday	string	Optional
selectediday	string	Optional
market	string	Optional
locale	string	Optional
currency	string	Optional

origin

IATA code for the origin. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Required	string	e.g. EDI, BCN, LIS

destination

IATA code for the destination. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Required	string	e.g. EDI, BCN, LIS

oym

Outbound month.

Required	Type	Format
Optional	string	YYYY-MM

iym

Inbound month.

Can only be used in combination with oym.

Required	Type	Format
Optional	string	YYYY-MM

adultsv2

Number of adult passengers. Adults have to be 18 years old or older.

Required	Type	Format	Default value
Optional	integer	e.g. 2	1

childrenv2

Number of children passengers. Child age has to be in the 2-17 range. The value must be in the format integer|integer... where each number is the age of the child passenger.

Required	Type	Format
Optional	string	e.g. 3|4|5

rtn

Trip type.

Required	Type
Optional	enum

The value of this property must be equal to one of the following values:

Value	Explanation
0	if oneway trip
1	if return or multicity trip

preferDirects

When this parameter is set to true, only direct flights results will be shown.

Required	Type	Format
Optional	boolean	false

selectedoday

Preselected outbound day of the month.

Required	Type	Format
Optional	integer	e.g. 10

selectediday

Preselected inbound day of the month.

Required	Type	Format
Optional	integer	e.g. 10

market

The preferred market for searching results.

When unspecified, we use detection logic to determine the market, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. UK, US, FR

locale

The preferred locale for the desired page.

When unspecified, we use detection logic to determine the locale, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. es-ES, en-GB, fr-FR

currency

The preferred currency for the desired page.

When unspecified, we use detection logic to determine the currency, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. GBP, EUR, USD

Flights Day View for Multi-City Search Schema

/flights/multicity

A schema definition for the flights day-view microsite supported query parameters.

Flights Day View for Multi-City Search Properties

Property	Type	Required
origin0	string	Required
date0	string	Required
destination0	string	Required
origin1	string	Optional
date1	string	Optional
destination1	string	Optional
origin2	string	Optional
date2	string	Optional
destination2	string	Optional
origin3	string	Optional
date3	string	Optional
destination3	string	Optional
origin4	string	Optional
date4	string	Optional
destination4	string	Optional
origin5	string	Optional
date5	string	Optional
destination5	string	Optional
adultsv2	integer	Optional
childrenv2	string	Optional
cabinclass	string	Optional
market	string	Optional
locale	string	Optional
currency	string	Optional

origin0

IATA code for the origin of the first flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Required	string	e.g. EDI, BCN, LIS

date0

Outbound date for the first flight.

Required	Type	Format
Required	string	YYYY-MM-DD

destination0

IATA code for the destination of the first flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Required	string	e.g. EDI, BCN, LIS

origin1

IATA code for the origin of the second flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

date1

Outbound date for the second flight.

Required	Type	Format
Optional	string	YYYY-MM-DD

destination1

IATA code for the destination of the second flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

origin2

IATA code for the origin of the third flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

date2

Outbound date for the third flight.

Required	Type	Format
Optional	string	YYYY-MM-DD

destination2

IATA code for the destination of the third flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

origin3

IATA code for the origin of the fourth flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

date3

Outbound date for the fourth flight.

Required	Type	Format
Optional	string	YYYY-MM-DD

destination3

IATA code for the destination of the fourth flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

origin4

IATA code for the origin of the fifth flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

date4

Outbound date for the fifth flight.

Required	Type	Format
Optional	string	YYYY-MM-DD

destination4

IATA code for the destination of the fifth flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

origin5

IATA code for the origin of the sixth flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

date5

Outbound date for the sixth flight.

Required	Type	Format
Optional	string	YYYY-MM-DD

destination5

IATA code for the destination of the sixth flight. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Optional	string	e.g. EDI, BCN, LIS

adultsv2

Number of adult passengers. Adults have to be 18 years old or older.

Required	Type	Format	Default value
Optional	integer	e.g. 2	1

childrenv2

Number of children passengers. Child age has to be in the 2-17 range. The value must be in the format integer|integer... where each number is the age of the child passenger.

Required	Type	Format
Optional	string	e.g. 3|4|5

cabinclass

Cabin class for the flight.

Required	Type	Default value
Optional	enum	economy

The value of this property must be equal to one of the following values:

ENUM values
economy
premiumeconomy
business
first

market

The preferred market for searching results.

When unspecified, we use detection logic to determine the market, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. UK, US, FR

locale

The preferred locale for the desired page.

When unspecified, we use detection logic to determine the locale, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. es-ES, en-GB, fr-FR

currency

The preferred currency for the desired page.

When unspecified, we use detection logic to determine the currency, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. GBP, EUR, USD

Cheap Flights To View Schema

/flights/cheap-flights-to

A schema definition for the cheap flights to microsite supported parameters.

Cheap Flights To View Properties

Property	Type	Required
destination	string	Required
market	string	Optional
locale	string	Optional
currency	string	Optional

destination

IATA code for the destination. IATA codes are available for airlines, airports and cities. They are often used internationally and recognised by multiple airlines and airports. Learn more

Required	Type	Format
Required	string	e.g. EDI, BCN, LIS

market

The preferred market for searching results.

When unspecified, we use detection logic to determine the market, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. UK, US, FR

locale

The preferred locale for the desired page.

When unspecified, we use detection logic to determine the locale, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. es-ES, en-GB, fr-FR

currency

The preferred currency for the desired page.

When unspecified, we use detection logic to determine the currency, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. GBP, EUR, USD

Flights Airline Schema

/flights/flights-airline

A schema definition for the flights airline microsite supported parameters.

Flights Airline Properties

Property	Type	Required
airlineCode	string	Required
market	string	Optional
locale	string	Optional
currency	string	Optional

airlineCode

The airline code.

Required	Type	Format
Required	string	e.g. BA

market

The preferred market for searching results.

When unspecified, we use detection logic to determine the market, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. UK, US, FR

locale

The preferred locale for the desired page.

When unspecified, we use detection logic to determine the locale, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. es-ES, en-GB, fr-FR

currency

The preferred currency for the desired page.

When unspecified, we use detection logic to determine the currency, so it is unlikely you will need to use this parameter. If you want to learn more, please visit our Localisation page.

Required	Type	Format
Optional	string	e.g. GBP, EUR, USD