Skip to main content
POST
Get live flight pricing — search by route, or re-price a known offer
Fetch live, bookable pricing for a specific route and date pair. Use it once the user has settled on exact travel dates, for example “Paris to New York departing June 1 returning June 8 in economy”. It also reprices an offer surfaced earlier by the calendar or destination tools so you can confirm availability before adding it to a trip.

Two modes, one endpoint

POST /v1/flight_search serves both modes:
  • Search mode: filter-based live search by origin, destination, departure_date, and passengers. Returns priced offers, each fare carrying a trip_item_token you can add to a trip.
  • Reprice mode: pass an offer_token from discovery (find_destination, flight_calendar) to re-price that specific offer before adding it to a trip. The other route fields are ignored when offer_token is present.
The CLI mirrors this: pass --offer-token for reprice mode, omit it for search mode.

Authorizations

X-API-Key
string
header
required

Body

application/json
origin
string
Example:

"JFK"

destination
string
Example:

"LAX"

departure_date
string
Pattern: ^\d{4}-\d{2}-\d{2}$
return_date
string
Pattern: ^\d{4}-\d{2}-\d{2}$
trip_type
enum<string>
Available options:
oneway,
roundtrip
cabin_class
enum<string>
Available options:
economy,
premium_economy,
business,
first
direct_only
boolean
max_price
number
Required range: x > 0
include_carriers
string[]
exclude_carriers
string[]
limit
integer

Max results to return (1-100). Default 20. Search mode only. Caps how many flights come back — only trims the set, since providers bound the real count.

Required range: 1 <= x <= 100
Example:

20

adults
integer
default:1
Required range: x >= 1
children
integer
Required range: x >= 0
infants
integer
Required range: x >= 0
currency
string
locale
string
offer_token
string
intent
object

Response

Priced offers

offers
object[]
required
exact_match_found
boolean
Example:

true