View the document at here.
https://documenter.getpostman.com/view/33975579/2sA3QpBswL#f307dae7-ee5e-4fca-9fb3-1ad1163410e8
You can use the id from this endpoint to search for flights.
Airports with id = null are those that are not available on Skyscanner
Parameter | Type | Description |
---|---|---|
query | string | Required: true Ex: `New York` |
placeTypes | string |
It can input multiple values, and the values should be separated by commas
The /flights/search-multi-city endpoint is only used in the case placeTypes=CITY,AIRPORT
Ex: `CITY,AIRPORT`
|
outboundDate | string | Format: 'YYYY-MM-DD' Default value: Current date |
market | string | `market` can be retrieved from /get-config endpoint(data->market) Ex: `US` Default value: `US` |
locale | string | `locale` can be retrieved from /get-config endpoint(data->locale) Ex: `en-US` Default value: `en-US` |
Parameter | Type | Description |
---|---|---|
fromEntityId | string |
From location
Required: true
`fromEntityId` can be retrieved from
Ex: |
toEntityId | string | To location toEntityId can be retrieved from
|
type | enum | Search type: oneway or roundtrip Default: oneway |
year | int | Depart year Format: YYYY Ex: 2024 |
month | int | Depart month Format: MM Ex: 05 |
market | string | market can be retrieved from /get-config endpoint(data->market)Ex: US Default value: US |
locale | string | locale can be retrieved from /get-config endpoint(data->locale)Ex: en-US Default value: en-US |
currency | string | currency can be retrieved from /get-config endpoint(data->currency)Ex: USD Default value: USD |
You can now search
Everywhere: leave toEntityId empty.
Anytime: leave departDate and returnDate empty.
The whole month: input wholeMonthDepart and wholeMonthReturn.
Parameter | Type | Description |
---|---|---|
fromEntityId | string | From location Required: true `fromEntityId` can be retrieved from /flights/auto-complete endpoint(data->navigation->relevantFlightParams->id) Ex: `ew0KICAicyIgOiAiUEFSSSIsDQogICJlIiA6ICIyNzUzOTczMyINCn0=` |
toEntityId | string | To location Required: true `fromEntityId` can be retrieved from /flights/auto-complete endpoint(data->navigation->relevantFlightParams->id) Ex: `ew0KICAicyIgOiAiTVNZQSIsDQogICJlIiA6ICIzNTIzNDg5MiINCn0=` |
wholeMonth | string | Select whole month Format: `YYYY-MM` Ex: `2024-02` |
departDate | string | Depart date Required: true Format: `YYYY-MM-DD` Ex: `2024-02-14` |
returnDate | string | Return date Required: true Format: `YYYY-MM-DD` Ex: `2024-02-15` |
stops | stops | Stops It can input multiple values, and the values should be separated by commas Ex: `direct,1stop` Default value: Select all `direct: Direct `1stop: 1 stop `2stops: 2+ stops |
market | string | `market` can be retrieved from /get-config endpoint(data->market) Ex: `US` Default value: `US` |
locale | string | `locale` can be retrieved from /get-config endpoint(data->locale) Ex: `en-US` Default value: `en-US` |
currency | string | `currency` can be retrieved from /get-config endpoint(data->currency) Ex: `USD` Default value: `USD` |
adults | int | Adults: 12+ years Ex: `3` Default value: `1` |
children | int | Children: 2-12 years Ex: `4` Default value: `0` |
infants | int | Infants: Under 2 years Ex: `1` Default value: `0` |
cabinClass | String |
Cabin class
Ex: `economy`
Default value: `economy`
|
You can now search
Everywhere: leave toEntityId empty.
Anytime: leave departDate empty.
The whole month: input wholeMonthDepart.
Parameter | Type | Description |
---|---|---|
fromEntityId | string | From location Required: true `fromEntityId` can be retrieved from /flights/auto-complete endpoint(data->navigation->relevantFlightParams->id) Ex: `ew0KICAicyIgOiAiUEFSSSIsDQogICJlIiA6ICIyNzUzOTczMyINCn0=` |
toEntityId | string | To location Required: true `fromEntityId` can be retrieved from /flights/auto-complete endpoint(data->navigation->relevantFlightParams->id) Ex: `ew0KICAicyIgOiAiTVNZQSIsDQogICJlIiA6ICIzNTIzNDg5MiINCn0=` |
departDate | string | Depart date Required: true Format: `YYYY-MM-DD` Ex: `2024-02-14` |
stops | stops | Stops It can input multiple values, and the values should be separated by commas Ex: `direct,1stop` Default value: Select all `direct`: Direct `1stop`: 1 stop `2stops`: 2+ stops |
market | string | `market` can be retrieved from /get-config endpoint(data->market) Ex: `US` Default value: `US` |
locale | string | `locale` can be retrieved from /get-config endpoint(data->locale) Ex: `en-US` Default value: `en-US` |
currency | string | `currency` can be retrieved from /get-config endpoint(data->currency) Ex: `USD` Default value: `USD` |
adults | int | Adults: 12+ years Ex: `3` Default value: `1` |
children | int | Children: 2-12 years Ex: `4` Default value: `0` |
infants | int | Infants: Under 2 years Ex: `1` Default value: `0` |
cabinClass | String |
Cabin class
Ex: `economy`
Default value: `economy`
|
Parameter | Type | Description |
---|---|---|
fromEntityId | string | From location Required: true `fromEntityId` can be retrieved from /flights/auto-complete endpoint(data->navigation->relevantFlightParams->id) Ex: `eyJlIjoiOTU1NjUwODUiLCJzIjoiQkNOIiwiaCI6IjI3NTQ4MjgzIn0=`Barcelona (BCN) |
toEntityId | string | To location Required: true `fromEntityId` can be retrieved from /flights/auto-complete endpoint(data->navigation->relevantFlightParams->id) Ex: `eyJlIjoiOTU2NzM3NDQiLCJzIjoiTlVFIiwiaCI6IjI3NTQ1MTYyIn0=` Nuremberg (NUE) |
departDate | string | Depart date Required: true Format: `YYYY-MM-DD` Ex: `2024-02-14` |
stops | stops | Stops It can input multiple values, and the values should be separated by commas Ex: `direct,1stop` Default value: Select all `direct: Direct `1stop: 1 stop `2stops: 2+ stops |
market | string | `market` can be retrieved from /get-config endpoint(data->market) Ex: `US` Default value: `US` |
locale | string | `locale` can be retrieved from /get-config endpoint(data->locale) Ex: `en-US` Default value: `en-US` |
currency | string | `currency` can be retrieved from /get-config endpoint(data->currency) Ex: `USD` Default value: `USD` |
adults | int | Adults: 12+ years Ex: `3` Default value: `1` |
children | int | Children: 2-12 years Ex: `4` Default value: `0` |
infants | int | Infants: Under 2 years Ex: `1` Default value: `0` |
cabinClass | String |
Cabin class
Ex: `economy`
Default value: `economy`
|
You need to call the API multiple times until the item status is ‘complete’(data->context->status=complete)
Parameter | Type | Description |
---|---|---|
sessionId | string | Session id Required: true `sessionId` can be retrieved from /flights/search-roundtrip or /flights/search-one-way endpoint(data->context->sessionId) Ex: `ClQIARJQCk4KJDU5MmY3YWI3LWRhNmItNDFjOC1hNmVlLWMwZGQ2M2I3MGM0MxACGiQzMDVkMDkzYy1iOGZjLTQ5MDAtODJkZC04OTNkMzQ5MWM4Yjc=` |
stops | stops | Stops It can input multiple values, and the values should be separated by commas Ex: `direct,1stop` Default value: Select all `direct: Direct `1stop: 1 stop `2stops: 2+ stops |
market | string | `market` can be retrieved from /get-config endpoint(data->market) Ex: `US` Default value: `US` |
locale | string | `locale` can be retrieved from /get-config endpoint(data->locale) Ex: `en-US` Default value: `en-US` |
currency | string | `currency` can be retrieved from /get-config endpoint(data->currency) Ex: `USD` Default value: `USD` |
Parameter | Type | Description |
---|---|---|
token | string | Token Required: true `token` can be retrieved from /flights/search-roundtrip or /flights/search-one-way endpoint(data->token) |
itineraryId | string | Itinerary id Required: true `itineraryId` can be retrieved from /flights/search-roundtrip or /flights/search-one-way or flights/search-incomplete endpoint(data->itineraries->id) |
market | string | `market` can be retrieved from /get-config endpoint(data->market) Ex: `US` Default value: `US` |
locale | string | `locale` can be retrieved from /get-config endpoint(data->locale) Ex: `en-US` Default value: `en-US` |
currency | string | `currency` can be retrieved from /get-config endpoint(data->currency) Ex: `USD` Default value: `USD` |
Parameter | Type | Description |
---|---|---|
fromEntityId | string | From location Required: true `fromEntityId` can be retrieved from /flights/auto-complete endpoint(data->navigation->relevantFlightParams->id) Ex: `eyJlIjoiOTU1NjUwNDEiLCJzIjoiQ0RHIiwiaCI6IjI3NTM5NzMzIiwidCI6IkFJUlBPUlQifQ==` (Paris Charles de Gaulle (CDG)) OR get from /flights/airports endpoint(data->iata or id) Ex: `CDG` |
departDate | string | Depart date Required: true Format: `YYYY-MM-DD` Ex: `2024-02-14` |
toEntityId | string | To location `toEntityId` can be retrieved from /flights/auto-complete endpoint(data->navigation->relevantFlightParams->id) Ex: `eyJlIjoiOTU1NjUwNTgiLCJzIjoiSkZLIiwiaCI6IjI3NTM3NTQyIiwidCI6IkFJUlBPUlQifQ==` (New York John F. Kennedy (JFK)) OR get from /flights/airports endpoint(data->iata or id) Ex: `JFK` |
market | string | `market` can be retrieved from /get-config endpoint(data->market) Ex: `US` Default value: `US` |
locale | string | `locale` can be retrieved from /get-config endpoint(data->locale) Ex: `en-US` Default value: `en-US` |
currency | string | `currency` can be retrieved from /get-config endpoint(data->currency) Ex: `USD` Default value: `USD` |