> ## 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-dates

> Best date options for a route — up to ten cheapest itineraries, one per date-pair, spread across the month

Answers "when should I fly?" for a known route. Takes the same inputs as Flight Calendar but returns up to ten cheapest itineraries — one per (departure, return) date-pair — spread across the requested departure window, so the user gets a diverse shortlist rather than ten near-adjacent cheapest days. Cache-backed; no live pricing. Each result includes an offer token you can pass into a live price check or directly into a trip.

## Usage

```bash theme={null}
jinko find-dates [options]
```

## Options

| Flag                        | Required | Description                                                                                      | Default |
| --------------------------- | -------- | ------------------------------------------------------------------------------------------------ | ------- |
| `--origins <codes...>`      | Yes      | origin IATA airport/city codes. JSON: `origins[]`.                                               |         |
| `--destinations <codes...>` | No       | destination IATA airport/city codes. Omit to scan all destinations. JSON: `destinations[]`.      |         |
| `--month <month>`           | No       | departure month to scan (YYYY-MM), defaults to current month                                     |         |
| `--trip-type <type>`        | No       | oneway or roundtrip (default: roundtrip). JSON: `trip_type`.                                     |         |
| `--stay-days <n>`           | No       | nights away for a roundtrip (default: 7). JSON: `stay_days`.                                     |         |
| `--cabin-class <class>`     | No       | cabin class: economy, premium\_economy, business, first (default: economy). JSON: `cabin_class`. |         |
| `--direct-only`             | No       | only direct flights. JSON: `direct_only`.                                                        |         |
| `--limit <n>`               | No       | max date-pairs to return (1-100, default 20). JSON: `limit`.                                     |         |
| `--from <origin>`           | No       | DEPRECATED: use --origins.                                                                       |         |
| `--to <destination>`        | No       | DEPRECATED: use --destinations.                                                                  |         |
| `--cabin <class>`           | No       | DEPRECATED: use --cabin-class.                                                                   |         |