Find Destination

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.

Tool description (what the LLM sees)

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.

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:

{
  "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:

{
  "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.

Introduction

Flights

Hotels

Cart & Payment

Parameters

Examples

​Parameters

​Examples

Parameters

Examples