Skip to main content
Surface inspiration when a user knows where they want to leave from but not where they want to go. Typical prompts include “cheap beach getaways from New York” or “weekend trips out of London under €200”. Results come back ranked by lowest available fare so the user can compare options before committing to a route.

​
Usage

jinko find-destination [options]

​
Options

FlagRequiredDescriptionDefault
--origins <codes...>YesIATA airport or city codes (e.g. JFK LGA). JSON: origins[].
--destinations <codes...>NoIATA airport or city codes to filter to. Omit for global discovery. JSON: destinations[].
--origin-type <type>NoHow to interpret —origins: city or airport (default: city). JSON: origin_type.
--destination-type <type>NoHow to interpret —destinations: city or airport (default: city). JSON: destination_type.
--departure-dates <dates...>NoExact departure dates (YYYY-MM-DD), OR logic. JSON: departure_dates[].
--departure-date-ranges <ranges...>NoFlexible departure ranges, repeatable. Format: YYYY-MM-DD:YYYY-MM-DD. JSON: departure_date_ranges[].
--return-dates <dates...>NoExact return dates (YYYY-MM-DD), roundtrip only. JSON: return_dates[].
--return-date-ranges <ranges...>NoFlexible return ranges, roundtrip only. Format: YYYY-MM-DD:YYYY-MM-DD. JSON: return_date_ranges[].
--stay-days <n>NoExact stay length in days. JSON: stay_days.
--stay-days-range <min:max>NoFlexible stay range, e.g. 5:10. JSON: stay_days_range.
--trip-type <type>Nooneway or roundtrip (inferred from —return-dates if omitted). JSON: trip_type.
--cabin-class <class>Noeconomy, premium_economy, business, or first (default: economy). JSON: cabin_class."economy"
--direct-onlyNoOnly return nonstop flights. JSON: direct_only.
--adults <n>NoAdult passengers (default: 1). JSON: adults.
--children <n>NoChild passengers. JSON: children.
--infants-in-lap <n>NoInfants on lap (no seat). JSON: infants_in_lap.
--infants-in-seat <n>NoInfants in own seat. JSON: infants_in_seat.
--youth <n>NoYouth fare. JSON: passengers.youth.
--student <n>NoStudent fare. JSON: passengers.student.
--ages <ages...>NoExplicit ages array (alternative to counts). JSON: ages[].
--residency-country <iso2>NoResidency country, ISO 3166-1 alpha-2. JSON: residency_country.
--max-total <amount>NoMaximum total price in —currency. JSON: max_total.
--currency <code>NoISO 4217 currency code (default: USD). JSON: currency.
--locale <bcp47>NoBCP 47 locale, e.g. en-US, fr-FR (default: en-US). JSON: locale.
--limit <n>NoMaximum destinations (1-100, default 20). JSON: limit."20"
--offset <n>NoPagination offset (default 0). JSON: offset.
--flights-per-destination <n>NoItineraries per destination (1-10, default 1). JSON: flights_per_destination.
--sort-by <strategy>Nolowest or recommendation (default: lowest). JSON: sort_by."lowest"
--from <origins...>NoDEPRECATED: use —origins.
--date <date>NoDEPRECATED: use —departure-dates.
--return <date>NoDEPRECATED: use —return-dates.
--departure-range <range>NoDEPRECATED: use —departure-date-ranges.
--stay <range>NoDEPRECATED: use —stay-days-range.
--cabin <class>NoDEPRECATED: use —cabin-class.
--max-price <amount>NoDEPRECATED: use —max-total.
--sort <strategy>NoDEPRECATED: use —sort-by.

​
Examples

Discover destinations reachable from your origins within a budget and date window: 
jinko find-destination \
  --origins JFK LGA EWR \
  --departure-date-ranges 2026-06-01:2026-06-30 \
  --stay-days-range 5:10 \
  --trip-type roundtrip \
  --adults 2 \
  --max-total 500 \
  --currency USD
The equivalent REST and SDK calls live in the API reference.