> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gojinko.com/llms.txt
> Use this file to discover all available pages before exploring further.
# jinko find-destination
> Discover travel destinations accessible from your departure airports
**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](/concepts/money).
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
```bash theme={null}
jinko find-destination [options]
```
## Options
| Flag | Required | Description | Default |
| ------------------------------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------- |
| `--origins ` | Yes | IATA airport or city codes (e.g. JFK LGA). JSON: `origins[]`. | |
| `--destinations ` | No | IATA airport or city codes to filter to. Omit for global discovery. JSON: `destinations[]`. | |
| `--origin-type ` | No | How to interpret --origins: `city` or `airport` (default: `city`). JSON: `origin_type`. | |
| `--destination-type ` | No | How to interpret --destinations: `city` or `airport` (default: `city`). JSON: `destination_type`. | |
| `--departure-dates ` | No | Exact departure dates (YYYY-MM-DD), OR logic. JSON: `departure_dates[]`. | |
| `--departure-date-ranges ` | No | Flexible departure ranges, repeatable. Format: `YYYY-MM-DD:YYYY-MM-DD`. JSON: `departure_date_ranges[]`. | |
| `--return-dates ` | No | Exact return dates (YYYY-MM-DD), roundtrip only. JSON: `return_dates[]`. | |
| `--return-date-ranges ` | No | Flexible return ranges, roundtrip only. Format: `YYYY-MM-DD:YYYY-MM-DD`. JSON: `return_date_ranges[]`. | |
| `--stay-days ` | No | Exact stay length in days. JSON: `stay_days`. | |
| `--stay-days-range ` | No | Flexible stay range, e.g. `5:10`. JSON: `stay_days_range`. | |
| `--trip-type ` | No | `oneway` or `roundtrip` (inferred from --return-dates if omitted). JSON: `trip_type`. | |
| `--cabin-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 ` | No | Adult passengers (default: 1). JSON: `adults`. | |
| `--children ` | No | Child passengers. JSON: `children`. | |
| `--infants-in-lap ` | No | Infants on lap (no seat). JSON: `infants_in_lap`. | |
| `--infants-in-seat ` | No | Infants in own seat. JSON: `infants_in_seat`. | |
| `--youth ` | No | Youth fare. JSON: `passengers.youth`. | |
| `--student ` | No | Student fare. JSON: `passengers.student`. | |
| `--ages ` | No | Explicit ages array (alternative to counts). JSON: `ages[]`. | |
| `--residency-country ` | No | Residency country, ISO 3166-1 alpha-2. JSON: `residency_country`. | |
| `--max-total ` | No | Maximum total price in --currency. JSON: `max_total`. | |
| `--currency ` | No | ISO 4217 currency code (default: USD). JSON: `currency`. | |
| `--locale ` | No | BCP 47 locale, e.g. `en-US`, `fr-FR` (default: `en-US`). JSON: `locale`. | |
| `--limit ` | No | Maximum destinations (1-100, default 20). JSON: `limit`. | `"20"` |
| `--offset ` | No | Pagination offset (default 0). JSON: `offset`. | |
| `--flights-per-destination ` | No | Itineraries per destination (1-10, default 1). JSON: `flights_per_destination`. | |
| `--sort-by ` | No | `lowest` or `recommendation` (default: `lowest`). JSON: `sort_by`. | `"lowest"` |
| `--user-intent ` | 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`. | |
## Examples
Discover destinations reachable from your origins within a budget and date window:
```bash theme={null}
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](/api/find-destination).