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

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

<Accordion title="Tool description (what the LLM sees)" defaultOpen={false}>
  ```text theme={null}
  Discover travel destinations accessible from your departure airports.

  Search globally or filter to specific regions. Returns destinations sorted by cheapest available flight.

  IMPORTANT: Use airport codes (CDG, ORY, JFK), NOT city codes (PAR, NYC). Include all nearby airports for best results (e.g., CDG + ORY for Paris).

  Next step: Use flight_calendar with the destination to get specific flights with offer_tokens for pricing.

  PRICES: min_price is already a decimal in major units (for example 49.25 with currency USD), display it as-is, do NOT divide it.
  ```
</Accordion>

## Parameters

| Name                            | Type                                                             | Required | Description                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ------------------------------- | ---------------------------------------------------------------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `origins`                       | `array<string>`                                                  | Yes      | Origin airport IATA codes or city codes (3 letters). Include all nearby airports. Examples: \["JFK", "LGA", "EWR"] for NYC.                                                                                                                                                                                                                                                                                                                    |
| `destinations`                  | `array<string>`                                                  | No       | Filter to specific destination IATA codes. Omit for global discovery mode.                                                                                                                                                                                                                                                                                                                                                                     |
| `trip_type`                     | `enum ("oneway" \| "roundtrip")`                                 | Yes      | Trip type: "oneway" or "roundtrip".                                                                                                                                                                                                                                                                                                                                                                                                            |
| `departure_dates`               | `array<string>`                                                  | No       | Specific departure dates (YYYY-MM-DD). Multiple dates searched with OR logic.                                                                                                                                                                                                                                                                                                                                                                  |
| `departure_date_ranges`         | `array<object>`                                                  | No       | Departure date ranges for flexible search.                                                                                                                                                                                                                                                                                                                                                                                                     |
| `departure_date_ranges[].start` | `string`                                                         | Yes      | Range start date (YYYY-MM-DD)                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `departure_date_ranges[].end`   | `string`                                                         | Yes      | Range end date (YYYY-MM-DD)                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `return_dates`                  | `array<unknown>`                                                 | No       | Specific return dates (YYYY-MM-DD) for round-trip flights.                                                                                                                                                                                                                                                                                                                                                                                     |
| `return_date_ranges`            | `array<object>`                                                  | No       | Return date ranges for flexible round-trip search.                                                                                                                                                                                                                                                                                                                                                                                             |
| `return_date_ranges[].start`    | `string`                                                         | Yes      | Range start date (YYYY-MM-DD)                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `return_date_ranges[].end`      | `string`                                                         | Yes      | Range end date (YYYY-MM-DD)                                                                                                                                                                                                                                                                                                                                                                                                                    |
| `stay_days`                     | `integer`                                                        | No       | Exact stay duration in days.                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `stay_days_range`               | `object`                                                         | No       | Flexible stay duration range. Example: \{min: 5, max: 10}                                                                                                                                                                                                                                                                                                                                                                                      |
| `stay_days_range.min`           | `integer`                                                        | Yes      | Minimum stay duration in days                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `stay_days_range.max`           | `integer`                                                        | Yes      | Maximum stay duration in days                                                                                                                                                                                                                                                                                                                                                                                                                  |
| `direct_only`                   | `boolean`                                                        | No       | Only return nonstop flights.                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `cabin_class`                   | `enum ("economy" \| "premium_economy" \| "business" \| "first")` | No       | Cabin class filter.                                                                                                                                                                                                                                                                                                                                                                                                                            |
| `max_total`                     | `number`                                                         | No       | Maximum total price for the trip (canonical name). Preferred over max\_price.                                                                                                                                                                                                                                                                                                                                                                  |
| `sort_by`                       | `enum ("lowest" \| "recommendation")`                            | No       | Sort order. Default: "lowest" (cheapest first).                                                                                                                                                                                                                                                                                                                                                                                                |
| `limit`                         | `integer`                                                        | No       | Max destinations to return per page (1-100). Default 20.                                                                                                                                                                                                                                                                                                                                                                                       |
| `offset`                        | `integer`                                                        | No       | Number of destinations to skip, for pagination. Default 0.                                                                                                                                                                                                                                                                                                                                                                                     |
| `currency`                      | `string`                                                         | No       | ISO 4217 currency code. Defaults to "USD".                                                                                                                                                                                                                                                                                                                                                                                                     |
| `locale`                        | `string`                                                         | No       | BCP 47 locale. Defaults to "en-US".                                                                                                                                                                                                                                                                                                                                                                                                            |
| `format`                        | `enum ("text" \| "json")`                                        | No       | Response format. "text" returns plain text for LLMs. "json" returns structured JSON.                                                                                                                                                                                                                                                                                                                                                           |
| `user_intent`                   | `string`                                                         | No       | The end user's current request in their own words, e.g. "find a cheap flight to Tokyo in mid-June". Pass it as-is when short; otherwise condense the goal and constraints into 1-2 sentences. Strip personal identifiers (names, emails, phone numbers, addresses, payment details), replace them with placeholders like "\[name]". Optional and never changes the result of the call; Jinko uses it to understand demand and improve results. |

## Examples

**Explore destinations under \$500 from New York in June:**

```json theme={null}
{
  "name": "find_destination",
  "arguments": {
    "origins": ["JFK", "LGA", "EWR"],
    "trip_type": "roundtrip",
    "departure_date_ranges": [{ "start": "2026-06-01", "end": "2026-06-30" }],
    "stay_days_range": { "min": 5, "max": 10 },
    "max_total": 500,
    "currency": "USD"
  }
}
```

**Europe from Paris in spring, direct only:**

```json theme={null}
{
  "name": "find_destination",
  "arguments": {
    "origins": ["CDG", "ORY"],
    "destinations": ["LHR", "AMS", "FRA", "MAD", "BCN", "ROM"],
    "trip_type": "roundtrip",
    "departure_date_ranges": [{ "start": "2026-04-01", "end": "2026-05-31" }],
    "stay_days": 3,
    "direct_only": true,
    "currency": "EUR"
  }
}
```

The response is a list of destinations sorted by cheapest found price, each with an `offer_token` you can pass into `flight_search` for live pricing.