Skip to main content
Omit --cabin-class when the user has not requested a cabin. Providers search economy by default, and other recognized cabins can still be returned. Explicit --cabin-class economy, premium_economy, business, or first strictly filters fares by the cabin on the longest segment; shorter connections may use another cabin. A live search with no matching offers exits successfully with code 0, reports no_matches, and includes an instruction: it asks the user which filter to relax when the search sent a narrowing filter, and otherwise whether to try other dates or airports. Keep their current filters until they agree to a change. This holds even when one airline source could not be searched, as long as another answered. JSON output carries the response body; table output prints the instruction. A search where every provider failed remains an error; retry later with the same filters when instructed. This behavior applies to route search, with reprice mode (--offer-token) retaining its existing behavior.
Prices in this command’s output are integers in minor units. Money objects carry decimal_places — divide by 10 ** decimal_places to display ({ "value": 15977, "decimal_places": 2 } is 159.77, not 15,977). See Money & prices.
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. Every filter that narrows the results is applied exactly as sent: no returned offer violates one, and the search never widens. Empty offers come with an instruction to relay: it asks which filter to relax when a narrowing filter was sent, and otherwise whether to try other dates or airports.

​
Usage

​
Options

​
Examples