find-destination

Discover travel destinations accessible from your departure airports

curl --request POST \
  --url https://api.gojinko.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-01",
      "end": "2026-09-30"
    }
  ],
  "stay_days": 7,
  "cabin_class": "economy",
  "max_total": 800,
  "currency": "USD",
  "flights_per_destination": 1
}
'

import requests

url = "https://api.gojinko.com/v1/find_destination"

payload = {
    "origins": ["NYC"],
    "trip_type": "roundtrip",
    "departure_date_ranges": [
        {
            "start": "2026-09-01",
            "end": "2026-09-30"
        }
    ],
    "stay_days": 7,
    "cabin_class": "economy",
    "max_total": 800,
    "currency": "USD",
    "flights_per_destination": 1
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    origins: ['NYC'],
    trip_type: 'roundtrip',
    departure_date_ranges: [{start: '2026-09-01', end: '2026-09-30'}],
    stay_days: 7,
    cabin_class: 'economy',
    max_total: 800,
    currency: 'USD',
    flights_per_destination: 1
  })
};

fetch('https://api.gojinko.com/v1/find_destination', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gojinko.com/v1/find_destination",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'origins' => [
        'NYC'
    ],
    'trip_type' => 'roundtrip',
    'departure_date_ranges' => [
        [
                'start' => '2026-09-01',
                'end' => '2026-09-30'
        ]
    ],
    'stay_days' => 7,
    'cabin_class' => 'economy',
    'max_total' => 800,
    'currency' => 'USD',
    'flights_per_destination' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gojinko.com/v1/find_destination"

	payload := strings.NewReader("{\n  \"origins\": [\n    \"NYC\"\n  ],\n  \"trip_type\": \"roundtrip\",\n  \"departure_date_ranges\": [\n    {\n      \"start\": \"2026-09-01\",\n      \"end\": \"2026-09-30\"\n    }\n  ],\n  \"stay_days\": 7,\n  \"cabin_class\": \"economy\",\n  \"max_total\": 800,\n  \"currency\": \"USD\",\n  \"flights_per_destination\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gojinko.com/v1/find_destination")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"origins\": [\n    \"NYC\"\n  ],\n  \"trip_type\": \"roundtrip\",\n  \"departure_date_ranges\": [\n    {\n      \"start\": \"2026-09-01\",\n      \"end\": \"2026-09-30\"\n    }\n  ],\n  \"stay_days\": 7,\n  \"cabin_class\": \"economy\",\n  \"max_total\": 800,\n  \"currency\": \"USD\",\n  \"flights_per_destination\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gojinko.com/v1/find_destination")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"origins\": [\n    \"NYC\"\n  ],\n  \"trip_type\": \"roundtrip\",\n  \"departure_date_ranges\": [\n    {\n      \"start\": \"2026-09-01\",\n      \"end\": \"2026-09-30\"\n    }\n  ],\n  \"stay_days\": 7,\n  \"cabin_class\": \"economy\",\n  \"max_total\": 800,\n  \"currency\": \"USD\",\n  \"flights_per_destination\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "priced_for": "one_adult",
  "destinations": [
    {
      "flights": [
        {
          "offer_token": "es-VVN8QUZ8MjAyNzA2MTU6QUY6Nzo6WXwyMDI3MDYyMjpBRjo2OjpZ",
          "id": "es-VVN8QUZ8MjAyNzA2MTU6QUY6Nzo6WXwyMDI3MDYyMjpBRjo2OjpZ",
          "origin": {
            "code": "JFK",
            "name": "New York John F. Kennedy"
          },
          "destination": {
            "code": "CDG",
            "name": "Paris Charles de Gaulle"
          },
          "total": {
            "value": 41250,
            "currency": "USD",
            "decimal_places": 2,
            "display": "USD 412.50"
          },
          "cabin_class": "economy",
          "outbound": {
            "origin": "JFK",
            "destination": "LAX",
            "departure_datetime": "2026-07-15T08:30:00-04:00",
            "arrival_datetime": "2026-07-15T11:55:00-07:00",
            "duration_minutes": 385,
            "airline": "AA",
            "airline_name": "American Airlines",
            "stops": 0,
            "stop_infos": [
              {
                "airport_code": "DFW",
                "duration_minutes": 95
              }
            ],
            "segments": [
              {
                "airline": "AA",
                "airline_name": "American Airlines",
                "flight_number": "460",
                "departure_airport": "JFK",
                "departure_city": "New York",
                "departure_time": "2026-09-23T11:55:00-04:00",
                "arrival_airport": "DFW",
                "arrival_city": "Dallas",
                "arrival_time": "2026-09-23T15:10:00-05:00",
                "duration_minutes": 255,
                "layover_minutes": 95,
                "operating_carrier": "MQ"
              }
            ]
          },
          "inbound": {
            "origin": "JFK",
            "destination": "LAX",
            "departure_datetime": "2026-07-15T08:30:00-04:00",
            "arrival_datetime": "2026-07-15T11:55:00-07:00",
            "duration_minutes": 385,
            "airline": "AA",
            "airline_name": "American Airlines",
            "stops": 0,
            "stop_infos": [
              {
                "airport_code": "DFW",
                "duration_minutes": 95
              }
            ],
            "segments": [
              {
                "airline": "AA",
                "airline_name": "American Airlines",
                "flight_number": "460",
                "departure_airport": "JFK",
                "departure_city": "New York",
                "departure_time": "2026-09-23T11:55:00-04:00",
                "arrival_airport": "DFW",
                "arrival_city": "Dallas",
                "arrival_time": "2026-09-23T15:10:00-05:00",
                "duration_minutes": 255,
                "layover_minutes": 95,
                "operating_carrier": "MQ"
              }
            ]
          },
          "priced_at": "2026-09-19T03:57:25Z"
        }
      ],
      "city_name": "Paris",
      "iata_code": "PAR",
      "image_url": "https://images.gojinko.com/destinations/par.jpg",
      "location": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "lowest_fare": {
        "offer_token": "es-VVN8QUZ8MjAyNzA2MTU6QUY6Nzo6WXwyMDI3MDYyMjpBRjo2OjpZ",
        "id": "es-VVN8QUZ8MjAyNzA2MTU6QUY6Nzo6WXwyMDI3MDYyMjpBRjo2OjpZ",
        "origin": {
          "code": "JFK",
          "name": "New York John F. Kennedy"
        },
        "destination": {
          "code": "CDG",
          "name": "Paris Charles de Gaulle"
        },
        "total": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "cabin_class": "economy",
        "outbound": {
          "origin": "JFK",
          "destination": "LAX",
          "departure_datetime": "2026-07-15T08:30:00-04:00",
          "arrival_datetime": "2026-07-15T11:55:00-07:00",
          "duration_minutes": 385,
          "airline": "AA",
          "airline_name": "American Airlines",
          "stops": 0,
          "stop_infos": [
            {
              "airport_code": "DFW",
              "duration_minutes": 95
            }
          ],
          "segments": [
            {
              "airline": "AA",
              "airline_name": "American Airlines",
              "flight_number": "460",
              "departure_airport": "JFK",
              "departure_city": "New York",
              "departure_time": "2026-09-23T11:55:00-04:00",
              "arrival_airport": "DFW",
              "arrival_city": "Dallas",
              "arrival_time": "2026-09-23T15:10:00-05:00",
              "duration_minutes": 255,
              "layover_minutes": 95,
              "operating_carrier": "MQ"
            }
          ]
        },
        "inbound": {
          "origin": "JFK",
          "destination": "LAX",
          "departure_datetime": "2026-07-15T08:30:00-04:00",
          "arrival_datetime": "2026-07-15T11:55:00-07:00",
          "duration_minutes": 385,
          "airline": "AA",
          "airline_name": "American Airlines",
          "stops": 0,
          "stop_infos": [
            {
              "airport_code": "DFW",
              "duration_minutes": 95
            }
          ],
          "segments": [
            {
              "airline": "AA",
              "airline_name": "American Airlines",
              "flight_number": "460",
              "departure_airport": "JFK",
              "departure_city": "New York",
              "departure_time": "2026-09-23T11:55:00-04:00",
              "arrival_airport": "DFW",
              "arrival_city": "Dallas",
              "arrival_time": "2026-09-23T15:10:00-05:00",
              "duration_minutes": 255,
              "layover_minutes": 95,
              "operating_carrier": "MQ"
            }
          ]
        },
        "priced_at": "2026-09-19T03:57:25Z"
      }
    }
  ],
  "total": 12,
  "next_page_token": "eyJvZmZzZXQiOjIwfQ=="
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Malformed JSON in request body.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "AUTH_REQUIRED",
    "message": "Invalid or expired API key.",
    "doc_url": "https://docs.gojinko.com/authentication/api-keys"
  }
}

{
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "Insufficient balance — this call costs $0.0150 and your organization has $0.0000 available. Top up at https://dashboard.gojinko.com/developers/billing/topup",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "CONFLICT",
    "message": "The operation conflicts with the current state of the resource.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "GONE",
    "message": "The resource no longer exists.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "A required field is missing or invalid.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Retry after the Retry-After delay.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "UPSTREAM_REJECTED",
    "message": "The request was declined for this offer. Try another offer.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "UPSTREAM_UNAVAILABLE",
    "message": "The service is temporarily unavailable. Retry after the Retry-After delay.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "UPSTREAM_TIMEOUT",
    "message": "The request timed out before a result was available. Retry the request.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

POST

find_destination

Discover travel destinations accessible from your departure airports

curl --request POST \
  --url https://api.gojinko.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-01",
      "end": "2026-09-30"
    }
  ],
  "stay_days": 7,
  "cabin_class": "economy",
  "max_total": 800,
  "currency": "USD",
  "flights_per_destination": 1
}
'

import requests

url = "https://api.gojinko.com/v1/find_destination"

payload = {
    "origins": ["NYC"],
    "trip_type": "roundtrip",
    "departure_date_ranges": [
        {
            "start": "2026-09-01",
            "end": "2026-09-30"
        }
    ],
    "stay_days": 7,
    "cabin_class": "economy",
    "max_total": 800,
    "currency": "USD",
    "flights_per_destination": 1
}
headers = {
    "X-API-Key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    origins: ['NYC'],
    trip_type: 'roundtrip',
    departure_date_ranges: [{start: '2026-09-01', end: '2026-09-30'}],
    stay_days: 7,
    cabin_class: 'economy',
    max_total: 800,
    currency: 'USD',
    flights_per_destination: 1
  })
};

fetch('https://api.gojinko.com/v1/find_destination', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.gojinko.com/v1/find_destination",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'origins' => [
        'NYC'
    ],
    'trip_type' => 'roundtrip',
    'departure_date_ranges' => [
        [
                'start' => '2026-09-01',
                'end' => '2026-09-30'
        ]
    ],
    'stay_days' => 7,
    'cabin_class' => 'economy',
    'max_total' => 800,
    'currency' => 'USD',
    'flights_per_destination' => 1
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-API-Key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.gojinko.com/v1/find_destination"

	payload := strings.NewReader("{\n  \"origins\": [\n    \"NYC\"\n  ],\n  \"trip_type\": \"roundtrip\",\n  \"departure_date_ranges\": [\n    {\n      \"start\": \"2026-09-01\",\n      \"end\": \"2026-09-30\"\n    }\n  ],\n  \"stay_days\": 7,\n  \"cabin_class\": \"economy\",\n  \"max_total\": 800,\n  \"currency\": \"USD\",\n  \"flights_per_destination\": 1\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-API-Key", "<api-key>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.gojinko.com/v1/find_destination")
  .header("X-API-Key", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"origins\": [\n    \"NYC\"\n  ],\n  \"trip_type\": \"roundtrip\",\n  \"departure_date_ranges\": [\n    {\n      \"start\": \"2026-09-01\",\n      \"end\": \"2026-09-30\"\n    }\n  ],\n  \"stay_days\": 7,\n  \"cabin_class\": \"economy\",\n  \"max_total\": 800,\n  \"currency\": \"USD\",\n  \"flights_per_destination\": 1\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.gojinko.com/v1/find_destination")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"origins\": [\n    \"NYC\"\n  ],\n  \"trip_type\": \"roundtrip\",\n  \"departure_date_ranges\": [\n    {\n      \"start\": \"2026-09-01\",\n      \"end\": \"2026-09-30\"\n    }\n  ],\n  \"stay_days\": 7,\n  \"cabin_class\": \"economy\",\n  \"max_total\": 800,\n  \"currency\": \"USD\",\n  \"flights_per_destination\": 1\n}"

response = http.request(request)
puts response.read_body

{
  "priced_for": "one_adult",
  "destinations": [
    {
      "flights": [
        {
          "offer_token": "es-VVN8QUZ8MjAyNzA2MTU6QUY6Nzo6WXwyMDI3MDYyMjpBRjo2OjpZ",
          "id": "es-VVN8QUZ8MjAyNzA2MTU6QUY6Nzo6WXwyMDI3MDYyMjpBRjo2OjpZ",
          "origin": {
            "code": "JFK",
            "name": "New York John F. Kennedy"
          },
          "destination": {
            "code": "CDG",
            "name": "Paris Charles de Gaulle"
          },
          "total": {
            "value": 41250,
            "currency": "USD",
            "decimal_places": 2,
            "display": "USD 412.50"
          },
          "cabin_class": "economy",
          "outbound": {
            "origin": "JFK",
            "destination": "LAX",
            "departure_datetime": "2026-07-15T08:30:00-04:00",
            "arrival_datetime": "2026-07-15T11:55:00-07:00",
            "duration_minutes": 385,
            "airline": "AA",
            "airline_name": "American Airlines",
            "stops": 0,
            "stop_infos": [
              {
                "airport_code": "DFW",
                "duration_minutes": 95
              }
            ],
            "segments": [
              {
                "airline": "AA",
                "airline_name": "American Airlines",
                "flight_number": "460",
                "departure_airport": "JFK",
                "departure_city": "New York",
                "departure_time": "2026-09-23T11:55:00-04:00",
                "arrival_airport": "DFW",
                "arrival_city": "Dallas",
                "arrival_time": "2026-09-23T15:10:00-05:00",
                "duration_minutes": 255,
                "layover_minutes": 95,
                "operating_carrier": "MQ"
              }
            ]
          },
          "inbound": {
            "origin": "JFK",
            "destination": "LAX",
            "departure_datetime": "2026-07-15T08:30:00-04:00",
            "arrival_datetime": "2026-07-15T11:55:00-07:00",
            "duration_minutes": 385,
            "airline": "AA",
            "airline_name": "American Airlines",
            "stops": 0,
            "stop_infos": [
              {
                "airport_code": "DFW",
                "duration_minutes": 95
              }
            ],
            "segments": [
              {
                "airline": "AA",
                "airline_name": "American Airlines",
                "flight_number": "460",
                "departure_airport": "JFK",
                "departure_city": "New York",
                "departure_time": "2026-09-23T11:55:00-04:00",
                "arrival_airport": "DFW",
                "arrival_city": "Dallas",
                "arrival_time": "2026-09-23T15:10:00-05:00",
                "duration_minutes": 255,
                "layover_minutes": 95,
                "operating_carrier": "MQ"
              }
            ]
          },
          "priced_at": "2026-09-19T03:57:25Z"
        }
      ],
      "city_name": "Paris",
      "iata_code": "PAR",
      "image_url": "https://images.gojinko.com/destinations/par.jpg",
      "location": {
        "latitude": 48.8566,
        "longitude": 2.3522
      },
      "lowest_fare": {
        "offer_token": "es-VVN8QUZ8MjAyNzA2MTU6QUY6Nzo6WXwyMDI3MDYyMjpBRjo2OjpZ",
        "id": "es-VVN8QUZ8MjAyNzA2MTU6QUY6Nzo6WXwyMDI3MDYyMjpBRjo2OjpZ",
        "origin": {
          "code": "JFK",
          "name": "New York John F. Kennedy"
        },
        "destination": {
          "code": "CDG",
          "name": "Paris Charles de Gaulle"
        },
        "total": {
          "value": 41250,
          "currency": "USD",
          "decimal_places": 2,
          "display": "USD 412.50"
        },
        "cabin_class": "economy",
        "outbound": {
          "origin": "JFK",
          "destination": "LAX",
          "departure_datetime": "2026-07-15T08:30:00-04:00",
          "arrival_datetime": "2026-07-15T11:55:00-07:00",
          "duration_minutes": 385,
          "airline": "AA",
          "airline_name": "American Airlines",
          "stops": 0,
          "stop_infos": [
            {
              "airport_code": "DFW",
              "duration_minutes": 95
            }
          ],
          "segments": [
            {
              "airline": "AA",
              "airline_name": "American Airlines",
              "flight_number": "460",
              "departure_airport": "JFK",
              "departure_city": "New York",
              "departure_time": "2026-09-23T11:55:00-04:00",
              "arrival_airport": "DFW",
              "arrival_city": "Dallas",
              "arrival_time": "2026-09-23T15:10:00-05:00",
              "duration_minutes": 255,
              "layover_minutes": 95,
              "operating_carrier": "MQ"
            }
          ]
        },
        "inbound": {
          "origin": "JFK",
          "destination": "LAX",
          "departure_datetime": "2026-07-15T08:30:00-04:00",
          "arrival_datetime": "2026-07-15T11:55:00-07:00",
          "duration_minutes": 385,
          "airline": "AA",
          "airline_name": "American Airlines",
          "stops": 0,
          "stop_infos": [
            {
              "airport_code": "DFW",
              "duration_minutes": 95
            }
          ],
          "segments": [
            {
              "airline": "AA",
              "airline_name": "American Airlines",
              "flight_number": "460",
              "departure_airport": "JFK",
              "departure_city": "New York",
              "departure_time": "2026-09-23T11:55:00-04:00",
              "arrival_airport": "DFW",
              "arrival_city": "Dallas",
              "arrival_time": "2026-09-23T15:10:00-05:00",
              "duration_minutes": 255,
              "layover_minutes": 95,
              "operating_carrier": "MQ"
            }
          ]
        },
        "priced_at": "2026-09-19T03:57:25Z"
      }
    }
  ],
  "total": 12,
  "next_page_token": "eyJvZmZzZXQiOjIwfQ=="
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Malformed JSON in request body.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "AUTH_REQUIRED",
    "message": "Invalid or expired API key.",
    "doc_url": "https://docs.gojinko.com/authentication/api-keys"
  }
}

{
  "error": {
    "code": "PAYMENT_REQUIRED",
    "message": "Insufficient balance — this call costs $0.0150 and your organization has $0.0000 available. Top up at https://dashboard.gojinko.com/developers/billing/topup",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Resource not found.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "CONFLICT",
    "message": "The operation conflicts with the current state of the resource.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "GONE",
    "message": "The resource no longer exists.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "BAD_REQUEST",
    "message": "A required field is missing or invalid.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "RATE_LIMITED",
    "message": "Too many requests. Retry after the Retry-After delay.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "UPSTREAM_REJECTED",
    "message": "The request was declined for this offer. Try another offer.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "UPSTREAM_UNAVAILABLE",
    "message": "The service is temporarily unavailable. Retry after the Retry-After delay.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

{
  "error": {
    "code": "UPSTREAM_TIMEOUT",
    "message": "The request timed out before a result was available. Retry the request.",
    "doc_url": "https://docs.gojinko.com/concepts/errors"
  }
}

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.

Prices are in minor units. value is an integer — divide by 10 ** decimal_places to display it. { "value": 15977, "decimal_places": 2 } is $159.77, not $15,977. See Money & prices.

Authorizations

X-API-Key

string

header

required

Body

application/json

origins

string[]

required

IATA city or airport codes. See origin_type for how an untyped code is read.

Minimum array length: 1

Example:

["NYC"]

trip_type

enum<string>

required

Available options:

oneway,

roundtrip

Example:

"roundtrip"

destinations

string[]

IATA city or airport codes. Omit for global discovery (find_destination) or to scan every destination from the origins. See destination_type for how an untyped code is read.

Example:

["PAR"]

origin_type

enum<string>

How to read the code: city searches every airport of the city, airport only that one airport. Omit it and the platform applies one rule: a code that names a multi-airport city is searched as the city; every other code is searched as the airport. Untyped NYC, LON or PAR is the city; untyped JFK, LHR or CDG is the airport; and untyped LAX, MIA or LAS — codes a city shares with its main airport — is the CITY, so results can land at any airport of that city. If the user named the airport, send airport; if they named the city, omit the field.

Available options:

city,

airport

Example:

"city"

destination_type

enum<string>

Available options:

city,

airport

Example:

"city"

departure_dates

string[]

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

["2026-07-15"]

departure_date_ranges

object[]

Show child attributes

return_dates

string[]

Pattern: ^\d{4}-\d{2}-\d{2}$

Example:

["2026-07-22"]

return_date_ranges

object[]

Show child attributes

stay_days

integer

Required range: x > 0

Example:

7

stay_days_range

object

Show child attributes

cabin_class

enum<string>

Available options:

economy,

premium_economy,

business,

first

Example:

"economy"

direct_only

boolean

Only direct flights. Cached fares record whether a fare is direct but not how many stops it makes, so this is the only stop filter here; POST /v1/flight_search takes max_stops.

Example:

false

accuracy

enum<string>

How strict the freshness check on cached fares is. standard (default) returns fares estimated to be at least 80% likely to still be available at the cached price; high raises that to 95%, so fewer fares come back.

Available options:

standard,

high

Example:

"standard"

max_total

number

Caps the cached fare's total. Cached fares are priced for one adult.

Required range: x > 0

Example:

800

currency

string

Example:

"USD"

locale

string

Example:

"en-US"

limit

integer

default:20

The maximum number of destinations returned, 1 to 100, default 20. It counts destinations, not itineraries: each destination carries up to flights_per_destination itineraries.

Required range: 1 <= x <= 100

offset

integer

default:0

Required range: x >= 0

sort_by

enum<string>

default:lowest

Available options:

lowest,

recommendation

intent

object

Show child attributes

flights_per_destination

integer

default:1

Required range: 1 <= x <= 10

Response

Matching destinations

priced_for

enum<string>

required

Whose price the cached fares in this answer are: always one_adult. Every cached total is one adult's fare; this request takes no passenger counts. Price the whole party with POST /v1/flight_search.

Available options:

one_adult

Example:

"one_adult"

destinations

object[]

required

Show child attributes

total

number

Example:

12

next_page_token

string

Example:

"eyJvZmZzZXQiOjIwfQ=="

Introduction

Travel Demand

Flights

Hotels

Cars

Trip & Payment

Marketing claim

Webhooks

Other endpoints

Authorizations

Body

Response