Skip to main content
Get live flight pricing and fare options. Provide exactly one of the “search” or “price_check” nested objects:
  1. search: Live flight search by route and dates. Example: { “search”: { “origin”: “PAR”, “destination”: “NYC”, “departure_date”: “2025-06-01” } } Required fields: origin, destination, departure_date. Optional: return_date, cabin_class, direct_only, origin_type, destination_type.
  2. price_check: Get live pricing for a specific flight deal from discovery tools (flight_calendar, find_destination, flight_calendar). Example: { “price_check”: { “offer_token”: “token_from_discovery” } }
IMPORTANT: “search” and “price_check” are nested objects, not string values. Do NOT pass them as strings. RESPONSE:
  • Each flight includes detailed segments, fare options with baggage/refund/change rules, and a trip_item_token per fare.
  • price_check may return status “flight_unavailable” with alternatives if the flight is no longer available — ask the user to choose.
NEXT STEP: Use the trip tool with add_item and the trip_item_token from the fare the user selects. Flow: discovery (flight_calendar / find_destination / flight_calendar) or direct search → flight_search → trip → book

​
Parameters

NameTypeRequiredDescription
searchobjectNoLive flight search by route and dates. Use city codes by default (PAR, NYC); use airport codes (CDG, JFK) only when the user specifies a particular airport.
search.originstringYesOrigin IATA city code (e.g. PAR, NYC, LON) or airport code (e.g. CDG, JFK, LHR). City codes preferred — they search all airports in the city.
search.origin_typeenum ("city" | "airport")NoWhether origin is a city code or airport code. Defaults to “city”.
search.destinationunknownYesDestination IATA city code (e.g. MIL, BCN, TYO) or airport code (e.g. MXP, BCN, NRT). City codes preferred.
search.destination_typeenum ("city" | "airport")NoWhether destination is a city code or airport code. Defaults to “city”.
search.departure_datestringYesDeparture date (YYYY-MM-DD)
search.return_datestringNoReturn date (YYYY-MM-DD) for round-trip.
search.cabin_classenum ("economy" | "premium_economy" | "business" | "first")NoCabin class filter.
search.direct_onlybooleanNoOnly return nonstop flights.
price_checkobjectNoGet live pricing for a specific flight deal. Returns confirmed fares with trip_item_token for booking.
price_check.offer_tokenstringYesoffer_token from flight_calendar, find_destination, or flight_calendar results.
passengersobjectNoPassenger counts. Defaults to 1 adult.
passengers.adultsintegerNoAdult travelers (12+)
passengers.childrenintegerNoChild travelers (2-11)
passengers.infantsintegerNoInfant travelers (under 2)
currencystringNoISO 4217 currency code. Defaults to “USD”.
localestringNoBCP 47 locale. Defaults to “en-US”.