--origins <codes...> | Yes | IATA airport or city codes (e.g. JFK LGA). JSON: origins[]. | |
--destinations <codes...> | No | IATA airport or city codes to filter to. Omit for global discovery. JSON: destinations[]. | |
--origin-type <type> | No | How to interpret —origins: city or airport (default: city). JSON: origin_type. | |
--destination-type <type> | No | How to interpret —destinations: city or airport (default: city). JSON: destination_type. | |
--departure-dates <dates...> | No | Exact departure dates (YYYY-MM-DD), OR logic. JSON: departure_dates[]. | |
--departure-date-ranges <ranges...> | No | Flexible departure ranges, repeatable. Format: YYYY-MM-DD:YYYY-MM-DD. JSON: departure_date_ranges[]. | |
--return-dates <dates...> | No | Exact return dates (YYYY-MM-DD), roundtrip only. JSON: return_dates[]. | |
--return-date-ranges <ranges...> | No | Flexible return ranges, roundtrip only. Format: YYYY-MM-DD:YYYY-MM-DD. JSON: return_date_ranges[]. | |
--stay-days <n> | No | Exact stay length in days. JSON: stay_days. | |
--stay-days-range <min:max> | No | Flexible stay range, e.g. 5:10. JSON: stay_days_range. | |
--trip-type <type> | No | oneway or roundtrip (inferred from —return-dates if omitted). JSON: trip_type. | |
--cabin-class <class> | No | economy, premium_economy, business, or first (default: economy). JSON: cabin_class. | "economy" |
--direct-only | No | Only return nonstop flights. JSON: direct_only. | |
--adults <n> | No | Adult passengers (default: 1). JSON: adults. | |
--children <n> | No | Child passengers. JSON: children. | |
--infants-in-lap <n> | No | Infants on lap (no seat). JSON: infants_in_lap. | |
--infants-in-seat <n> | No | Infants in own seat. JSON: infants_in_seat. | |
--youth <n> | No | Youth fare. JSON: passengers.youth. | |
--student <n> | No | Student fare. JSON: passengers.student. | |
--ages <ages...> | No | Explicit ages array (alternative to counts). JSON: ages[]. | |
--residency-country <iso2> | No | Residency country, ISO 3166-1 alpha-2. JSON: residency_country. | |
--max-total <amount> | No | Maximum total price in —currency. JSON: max_total. | |
--currency <code> | No | ISO 4217 currency code (default: USD). JSON: currency. | |
--locale <bcp47> | No | BCP 47 locale, e.g. en-US, fr-FR (default: en-US). JSON: locale. | |
--limit <n> | No | Maximum destinations (1-100, default 20). JSON: limit. | "20" |
--offset <n> | No | Pagination offset (default 0). JSON: offset. | |
--flights-per-destination <n> | No | Itineraries per destination (1-10, default 1). JSON: flights_per_destination. | |
--sort-by <strategy> | No | lowest or recommendation (default: lowest). JSON: sort_by. | "lowest" |
--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. | |
