> ## 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 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.
  ```
</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.                                                                                  |
| `return_dates`          | `array<unknown>`                                                 | No       | Specific return dates (YYYY-MM-DD) for round-trip flights.                                                                  |
| `return_date_ranges`    | `array<unknown>`                                                 | No       | Return date ranges for flexible round-trip search.                                                                          |
| `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.                                               |
| `max_price`             | `number`                                                         | No       | Deprecated alias for max\_total. Use max\_total instead.                                                                    |
| `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.                                        |

## 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_price": 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.