> ## 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.
# 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.
```text theme={null}
Find the best date options for a known origin and destination using cached pricing. 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 sees a diverse set of "when should I fly?" options rather than the full per-date list.
WHEN TO USE THIS TOOL:
- The user knows the route (origin AND destination) and is flexible on WHEN, and wants a short, spread-out shortlist of the best date options.
- Examples: "When is the cheapest time to fly Paris → New York in June?", "Best weekends to go from London to Lisbon next month", "Give me a few good date options for a week in Tokyo".
WHEN TO USE flight_calendar INSTEAD:
- The user wants the full price-per-date list / calendar grid for a route, not a curated shortlist.
WHEN TO USE flight_search INSTEAD:
- The user has committed to EXACT dates (single departure AND single return). flight_search hits live pricing and is the step before booking.
IMPORTANT:
All dates MUST be in the future. Never use past dates.
Origin and destination must be IATA city codes by default, or IATA airport codes if the user specifies them.
By default search roundtrip unless the user explicitly asks for one-way (trip_type="oneway").
Flow: find_dates → flight_search (price-check the chosen dates) → trip → checkout
```
## Parameters
| Name | Type | Required | Description |
| ----------------------- | ---------------------------------------------------------------- | -------- | ------------------------------------------------------------------------------------ |
| `origin` | `string` | Yes | Origin airport IATA code or city code (3 letters). Examples: "JFK", "PAR". |
| `destination` | `string` | Yes | Destination airport IATA code or city code (3 letters). Examples: "CDG", "NRT". |
| `trip_type` | `enum ("oneway" \| "roundtrip")` | Yes | Trip type: "oneway" or "roundtrip". |
| `departure_dates` | `array` | No | Specific departure dates (YYYY-MM-DD). Multiple dates searched with OR logic. |
| `departure_date_ranges` | `array