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

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

<Note>
  **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).
</Note>

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`.                                                                                                              |         |
| `--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`. |         |