The Browse Routes Service returns the cheapest price per day from our cache data. It provides an aggregated view of flight and price data for many origins, or many destinations over many time frames, returning the cheapest quotes, where available.
The Browse Routes API is used to determine the origin and destination for the journey. It provides a view of flights and fares for a specified choice of destination which can vary in the level of precision. The origin can range from an airport to a country. The destination can range from an airport to a country, or ‘anywhere’ to see all possible destinations.
If dates are known already they can be used to filter the search criteria at any level.
The following tables show the level of precision supported for the origin and destination places, and the outbound and return dates:
Possible query types are:
- Country to Anywhere (which other countries can be reached from the supplied country)
- City to Anywhere (which countries can be reached from the supplied city)
- Airport to Anywhere (which countries can be reached from the supplied airport)
- Country to Country (which destination airports are available from the origin country)
- City to Country (which destinations within the country are available from the given city)
- Airport to Country (which destinations within the country are available from the given airport)
- Country to City (and the reverse)
- Country to Airport (and the reverse)
Examples of questions that can be answered are:
- Find me the cheapest price for each available route from London to France for the next year. This gives the cheapest known price for each airport in France.
- Find me the cheapest price for each available route from London to anywhere departing in January and returning in February. This gives the cheapest known price for each destination country that can be reached from London.
The service uses an HTTP GET request.
The data will be returned in XML format by default. An HTTP Accept header value of ‘application/json’ should be specified to return data in JSON format.
The X-Forwarded-For header must be included with the end user’s IP address. Unless agreed in advance, Skyscanner will be performing robot detection and reserves the right to suspend access to the service without prior notification.
Http Response Codes
|400||Bad Request – Input validation failed.|
|403||Forbidden – The API Key was not supplied, or it was invalid, or it is not authorized to access the service.|
|429||Too Many Requests – There have been too many requests in the last minute.|
|500||Server Error – An internal server error has occurred which has been logged.|
|Routes||A collection of all available routes together with the total price of the cheapest journey option for each route. A timestamp with the date the quote was first known to be correct (see messaging requirements)|
|Quotes||The cheapest quote with:
|Places||A normalized cross reference lookup of Place information.|
|Currencies||Details on how to display the currency specified in the query.|
Country to Anywhere
City to Anywhere
City to Country