Skip to main content
POST
Discover travel destinations accessible from your departure airports
Surface inspiration when a user knows where they want to leave from but not where they want to go. Typical prompts include “cheap beach getaways from New York” or “weekend trips out of London under €200”. Results come back ranked by lowest available fare so the user can compare options before committing to a route.
Prices are in minor units. value is an integer — divide by 10 ** decimal_places to display it. { "value": 15977, "decimal_places": 2 } is $159.77, not $15,977. See Money & prices.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
origins
string[]
required

IATA city or airport codes. See origin_type for how an untyped code is read.

Minimum array length: 1
Example:
​
trip_type
enum<string>
required
Available options:
oneway,
roundtrip
Example:

"roundtrip"

​
destinations
string[]

IATA city or airport codes. Omit for global discovery (find_destination) or to scan every destination from the origins. See destination_type for how an untyped code is read.

Example:
​
origin_type
enum<string>

How to read the code: city searches every airport of the city, airport only that one airport. Omit it and the platform applies one rule: a code that names a multi-airport city is searched as the city; every other code is searched as the airport. Untyped NYC, LON or PAR is the city; untyped JFK, LHR or CDG is the airport; and untyped LAX, MIA or LAS — codes a city shares with its main airport — is the CITY, so results can land at any airport of that city. If the user named the airport, send airport; if they named the city, omit the field.

Available options:
city,
airport
Example:

"city"

​
destination_type
enum<string>

How to read the code: city searches every airport of the city, airport only that one airport. Omit it and the platform applies one rule: a code that names a multi-airport city is searched as the city; every other code is searched as the airport. Untyped NYC, LON or PAR is the city; untyped JFK, LHR or CDG is the airport; and untyped LAX, MIA or LAS — codes a city shares with its main airport — is the CITY, so results can land at any airport of that city. If the user named the airport, send airport; if they named the city, omit the field.

Available options:
city,
airport
Example:

"city"

​
departure_dates
string[]
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:
​
departure_date_ranges
object[]
​
return_dates
string[]
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:
​
return_date_ranges
object[]
​
stay_days
integer
Required range: x > 0
Example:

7

​
stay_days_range
object
​
cabin_class
enum<string>
Available options:
economy,
premium_economy,
business,
first
Example:

"economy"

​
direct_only
boolean

Only direct flights. Cached fares record whether a fare is direct but not how many stops it makes, so this is the only stop filter here; POST /v1/flight_search takes max_stops.

Example:

false

​
accuracy
enum<string>

How strict the freshness check on cached fares is. standard (default) returns fares estimated to be at least 80% likely to still be available at the cached price; high raises that to 95%, so fewer fares come back.

Available options:
standard,
high
Example:

"standard"

​
max_total
number

Caps the cached fare's total. Cached fares are priced for one adult.

Required range: x > 0
Example:

800

​
currency
string
Example:

"USD"

​
locale
string
Example:

"en-US"

​
limit
integer
default:20

The maximum number of destinations returned, 1 to 100, default 20. It counts destinations, not itineraries: each destination carries up to flights_per_destination itineraries.

Required range: 1 <= x <= 100
​
offset
integer
default:0
Required range: x >= 0
​
sort_by
enum<string>
default:lowest

The order of the results. lowest, the only order today, is cheapest first by the cached one-adult total; on find_destination it orders destinations by their cheapest itinerary. Omit it for the same order.

Available options:
lowest
​
intent
object
​
flights_per_destination
integer
default:1
Required range: 1 <= x <= 10

Response

Matching destinations

​
priced_for
enum<string>
required

Whose price the cached fares in this answer are: always one_adult. Every cached total is one adult's fare; this request takes no passenger counts. Price the whole party with POST /v1/flight_search.

Available options:
one_adult
Example:

"one_adult"

​
destinations
object[]
required
​
total
number
Example:

12

​
next_page_token
string
Example:

"eyJvZmZzZXQiOjIwfQ=="