--origin <code> | Yes | departure airport, 3-letter IATA airport code. JSON: origin. | |
--destination <code> | Yes | arrival airport, 3-letter IATA airport code. JSON: destination. | |
--departure-date <date> | Yes | outbound date (YYYY-MM-DD). JSON: departure_date. | |
--trip-type <type> | Yes | oneway or roundtrip; roundtrip needs —return-date. JSON: trip_type. | |
--return-date <date> | No | return date (YYYY-MM-DD), round trips only. JSON: return_date. | |
--cabin-class <class> | No | economy, premium_economy, business or first; omit for every cabin. JSON: cabin_class. | |
--adults <n> | No | travelers, 1-9 (default 1): every fare has at least this many award seats. JSON: adults. | |
--max-stops <n> | No | maximum stops in each direction: 0, 1 or 2. JSON: max_stops. | |
--include-carriers <codes...> | No | keep only itineraries whose every segment is marketed by these IATA carriers. JSON: include_carriers. | |
--exclude-carriers <codes...> | No | drop itineraries with a segment marketed by these IATA carriers. JSON: exclude_carriers. | |
--single-carrier-only | No | keep only itineraries marketed end-to-end by one carrier. JSON: single_carrier_only. | |
--via-airports <codes...> | No | keep only itineraries that connect at one of these airports; nonstops are kept. JSON: via_airports. | |
--exclude-via-airports <codes...> | No | drop itineraries that connect at any of these airports. JSON: exclude_via_airports. | |
--aircraft-types <codes...> | No | keep only itineraries flown on these IATA equipment codes (e.g. 77W 789). JSON: aircraft_types. | |
--departure-time-range <window> | No | outbound local departure time-of-day, HH:MM-HH:MM (either bound may be omitted). JSON: departure_time_range. | |
--arrival-time-range <window> | No | outbound local arrival time-of-day, HH:MM-HH:MM. JSON: arrival_time_range. | |
--return-departure-time-range <window> | No | return local departure time-of-day, HH:MM-HH:MM (round trips only). JSON: return_departure_time_range. | |
--return-arrival-time-range <window> | No | return local arrival time-of-day, HH:MM-HH:MM (round trips only). JSON: return_arrival_time_range. | |
--connection-time-min-minutes <n> | No | shortest acceptable connection, in minutes. JSON: connection_time_min_minutes. | |
--connection-time-max-minutes <n> | No | longest acceptable connection, in minutes. JSON: connection_time_max_minutes. | |
--max-total-duration-minutes <n> | No | longest journey time in each direction, in minutes. JSON: max_total_duration_minutes. | |
--same-connection-airport-only | No | keep only itineraries whose connections leave from the airport they arrived at. JSON: same_connection_airport_only. | |
--limit <n> | No | flights returned, 1-100 (default 50); total counts every match. JSON: limit. | |
--programs <codes...> | No | loyalty programs to search, by code: aadvantage, atmos_rewards, skymiles, flying_blue, flying_club, trueblue, qantas_frequent_flyer, eurobonus, miles_and_smiles, mileageplus, velocity, etihad_guest, finnair_plus, aeromexico_rewards, azul_fidelidade, smiles_br, smiles_ar. Omit for all 17. JSON: programs. | |
--max-miles <n> | No | most miles per traveler; on a round trip, outbound plus return. JSON: max_miles. | |
--saver-only | No | keep only saver-level awards; programs without a saver level are not affected. JSON: saver_only. | |
--max-mixed-cabin-share <share> | No | largest share of flying time (0 to 1) allowed in a lower cabin; 0 keeps the requested cabin end to end. JSON: max_mixed_cabin_share. | |
--sort <order> | No | miles (default), departure or duration. JSON: sort. | |
--user-intent <text> | No | the end user’s request in their own words, forwarded to Jinko for observability and relevance (avoid PII). Env fallback: JINKO_USER_INTENT. JSON: intent.user_intent. | |
