Skip to main content
POST
/
v1
/
find_destination
Discover travel destinations accessible from your departure airports
curl --request POST \
  --url https://api.example.com/v1/find_destination \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "origins": [
    "NYC"
  ],
  "trip_type": "roundtrip",
  "departure_date_ranges": [
    {
      "start": "2026-09-01T00:00:00.000Z",
      "end": "2026-09-30T00:00:00.000Z"
    }
  ],
  "stay_days": 7,
  "cabin_class": "economy",
  "adults": 1,
  "max_total": 800,
  "currency": "USD",
  "flights_per_destination": 1
}
'
{
  "destinations": [
    {
      "flights": [
        {
          "id": "itin_9f3b2a17",
          "origin": {
            "code": "JFK",
            "name": "New York John F. Kennedy"
          },
          "destination": {
            "code": "CDG",
            "name": "Paris Charles de Gaulle"
          },
          "total": {
            "value": 412.5,
            "currency": "USD",
            "decimal_places": 2
          },
          "cabin_class": "economy"
        }
      ],
      "city_name": "Paris",
      "iata_code": "PAR",
      "image_url": "https://images.gojinko.com/destinations/par.jpg",
      "location": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "lowest_fare": {
        "id": "itin_9f3b2a17",
        "origin": {
          "code": "JFK",
          "name": "New York John F. Kennedy"
        },
        "destination": {
          "code": "CDG",
          "name": "Paris Charles de Gaulle"
        },
        "total": {
          "value": 412.5,
          "currency": "USD",
          "decimal_places": 2
        },
        "cabin_class": "economy"
      }
    }
  ],
  "total": 12,
  "next_page_token": "eyJvZmZzZXQiOjIwfQ=="
}
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.

Authorizations

​
X-API-Key
string
header
required

Body

application/json
​
origins
string[]
required
Minimum array length: 1
Example:
["NYC"]
​
trip_type
enum<string>
required
Available options:
oneway,
roundtrip
Example:

"roundtrip"

​
destinations
string[]
Example:
["PAR"]
​
origin_type
enum<string>
default:city
Available options:
city,
airport
​
destination_type
enum<string>
default:city
Available options:
city,
airport
​
departure_dates
string[]
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:
["2026-07-15T00:00:00.000Z"]
​
departure_date_ranges
object[]
​
return_dates
string[]
Pattern: ^\d{4}-\d{2}-\d{2}$
Example:
["2026-07-22T00:00:00.000Z"]
​
return_date_ranges
object[]
​
stay_days
integer
Required range: x > 0
Example:

7

​
stay_days_range
object
​
cabin_class
enum<string>
Available options:
economy,
premium_economy,
business,
first
Example:

"economy"

​
direct_only
boolean
Example:

false

​
adults
integer
Required range: x >= 0
Example:

1

​
children
integer
Required range: x >= 0
​
infants_in_lap
integer
Required range: x >= 0
​
infants_in_seat
integer
Required range: x >= 0
​
youth
integer
Required range: x >= 0
​
student
integer
Required range: x >= 0
​
ages
integer[]
Required range: x >= 0
​
residency_country
string
Required string length: 2
​
max_total
number
Required range: x > 0
Example:

800

​
currency
string
Example:

"USD"

​
locale
string
Example:

"en-US"

​
limit
integer
default:20
Required range: 1 <= x <= 100
​
offset
integer
default:0
Required range: x >= 0
​
sort_by
enum<string>
default:lowest
Available options:
lowest,
recommendation
​
flights_per_destination
integer
default:1
Required range: 1 <= x <= 10

Response

Matching destinations

​
destinations
object[]
required
​
total
number
Example:

12

​
next_page_token
string
Example:

"eyJvZmZzZXQiOjIwfQ=="