Skip to main content
API docs by Redocly

Flights live pricing API (3.0)

FlightsService

/itineraryrefresh/create

path Parameters
sessionToken
required
string

Create/Poll search session token.

Request Body schema: application/json
required
itineraryId
string

The itinerary id for the price refresh.

Responses

Request samples

Content type
application/json
{
  • "itineraryId": "string"
}

Response samples

Content type
application/json
{
  • "refreshSessionToken": "string",
  • "status": "RESULT_STATUS_UNSPECIFIED",
  • "content": {
    },
  • "degradationReasons": [
    ]
}

/itineraryrefresh/poll

path Parameters
refreshSessionToken
required
string

Session token used to refresh the itinerary prices.

Responses

Response samples

Content type
application/json
{
  • "refreshSessionToken": "string",
  • "status": "RESULT_STATUS_UNSPECIFIED",
  • "content": {
    },
  • "degradationReasons": [
    ]
}

/search/create

Authorizations:
UserAuth
Request Body schema: application/json
required

Create search request object.

object (rpcflightsliveQuery)

Query object for request.

market
string

Market for which the search is for. e.g. UK. We provide a Culture API to get all the markets we support. See Culture API Documentation.

locale
string

Locale that the results are returned in. e.g. en-GB. We provide a Culture API to get all the locales we support. See Culture API Documentation.

currency
string

Currency that the search results are returned in. e.g. GBP. We provide a Culture API to get all the currencies we support. See Culture API Documentation.

Array of objects (liveQueryLeg)

List of legs to search for.

cabinClass
string (liveCabinClass)
Default: "CABIN_CLASS_UNSPECIFIED"
Enum: "CABIN_CLASS_UNSPECIFIED" "CABIN_CLASS_ECONOMY" "CABIN_CLASS_PREMIUM_ECONOMY" "CABIN_CLASS_BUSINESS" "CABIN_CLASS_FIRST"

Cabin class Enum to specify class. E.g.: economy, business, first.

  • CABIN_CLASS_UNSPECIFIED: cabin class is not specified.
  • CABIN_CLASS_ECONOMY: cabin class is economy.
  • CABIN_CLASS_PREMIUM_ECONOMY: cabin class is premium economy.
  • CABIN_CLASS_BUSINESS: cabin class is business.
  • CABIN_CLASS_FIRST: cabin class is first class.
adults
integer <int32>

Number of adults. Should be greater than or equal to 1.

childrenAges
Array of integers <int32> [ items <int32 > ]

List of children ages.

includedCarriersIds
Array of strings

List of included carriers.

excludedCarriersIds
Array of strings

List of excluded carriers.

includedAgentsIds
Array of strings

List of included agents.

excludedAgentsIds
Array of strings

List of excluded agents.

includeSustainabilityData
boolean

Option to include sustainability data.

nearbyAirports
boolean

Option to include nearby airports Please note that this option relates only for the origin. Nearby airports for the destination is not supported at the moment.

includeBaggageData
boolean (Include Baggage Data flag)

Option to include baggage and other additional attribute fields as part of the response. Please note that the baggage and other additional attribute will not be returned unless you've onboarded into the Baggage and Additional Attributes feature by speaking to your Skyscanner account manager.

Responses

Request samples

Content type
application/json
{
  • "query": {
    }
}

Response samples

Content type
application/json
{
  • "sessionToken": "string",
  • "status": "RESULT_STATUS_UNSPECIFIED",
  • "action": "RESULT_ACTION_UNSPECIFIED",
  • "content": {
    }
}

/search/poll

Authorizations:
UserAuth
path Parameters
sessionToken
required
string

Session token required for polling operations.

Responses

Response samples

Content type
application/json
{
  • "sessionToken": "string",
  • "status": "RESULT_STATUS_UNSPECIFIED",
  • "action": "RESULT_ACTION_UNSPECIFIED",
  • "content": {
    }
}