> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dev.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

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 <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"`  |
| `--from <origins...>`                 | No       | DEPRECATED: use --origins.                                                                               |             |
| `--date <date>`                       | No       | DEPRECATED: use --departure-dates.                                                                       |             |
| `--return <date>`                     | No       | DEPRECATED: use --return-dates.                                                                          |             |
| `--departure-range <range>`           | No       | DEPRECATED: use --departure-date-ranges.                                                                 |             |
| `--stay <range>`                      | No       | DEPRECATED: use --stay-days-range.                                                                       |             |
| `--cabin <class>`                     | No       | DEPRECATED: use --cabin-class.                                                                           |             |
| `--max-price <amount>`                | No       | DEPRECATED: use --max-total.                                                                             |             |
| `--sort <strategy>`                   | No       | DEPRECATED: use --sort-by.                                                                               |             |

## 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).