Kiwi.com Explore Destinations API Documentation Get the cheapest flight to each destination from an origin on one departure date. The destination is anywhere by default, or a country or place id. Add nights_min and nights_max for return trips. Each row has the destination airport, the price, the departure time and, for return trips, the return time and nights. Prices are offers for the date and party. Open the flight search for the full itinerary.
Run this endpoint
Endpoint
Parameters
Start with the required fields, then add optional filters only when your use case needs them.
Runnable path
2 required parameters needed before sending a request.
13 optional filters available.
string
Required
Place id or airport code of the origin. Example: City:berlin_de.
example
string
Required
Departure date, YYYY-MM-DD, today or later.
2026-06-15
string
Optional
Place id, country id or anywhere. Defaults to anywhere.
example
integer
Optional
Shortest stay in nights, 1 to 60. Send it with nights_max for a return calendar.
10
integer
Optional
Longest stay in nights, 1 to 60, not below nights_min.
10
integer
Optional
Adults, 1 to 9. Defaults to 1. Adults, children and infants together are at most 9.
10
integer
Optional
Children, 0 to 8. Defaults to 0.
10
integer
Optional
Infants, 0 to 8. Each infant needs an adult. Defaults to 0.
10
string
Optional
economy, premium_economy, business or first. Defaults to economy.
example
integer
Optional
Maximum stops, 0 to 3.
10
integer
Optional
Minimum price in the chosen currency.
10
integer
Optional
Maximum price in the chosen currency.
10
integer
Optional
Destinations to return, 1 to 50. Defaults to 30.
10
string
Optional
Price currency, a 3-letter code such as EUR or USD. Defaults to EUR.
USD
string
Optional
Language of names, such as en or de. Defaults to en.
en-US
Response Schema
Example response fields are illustrative; inspect the JSON before integrating.
Example response fields
Scan these fields before integrating.
data
meta
success
{
"data": {
"limit": 3,
"nights": null,
"notice": null,
"origin": "City:berlin_de",
"currency": "EUR",
"trip_type": "one_way",
"destination": "anywhere",
"destinations": [
{
"price": {
"amount": 70,
"currency": "EUR",
"formatted": "70 \u20ac"
},
"nights": null,
"origin": {
"id": "Station:airport:BER",
"name": "Berlin Brandenburg"
},
"destination": {
"id": "Station:airport:PMI",
"name": "Palma de Mallorca"
},
"return_time": null,
"departure_time": "2026-11-19T19:55:00",
"discount_percentage": null
},
{
"price": {
"amount": 82,
"currency": "EUR",
"formatted": "82 \u20ac"
},
"nights": null,
"origin": {
"id": "Station:airport:BER",
"name": "Berlin Brandenburg"
},
"destination": {
"id": "Station:airport:SAW",
"name": "Sabiha G\u00f6k\u00e7en International"
},
"return_time": null,
"departure_time": "2026-11-19T13:40:00",
"discount_percentage": null
},
{
"price": {
"amount": 176,
"currency": "EUR",
"formatted": "176 \u20ac"
},
"nights": null,
"origin": {
"id": "Station:airport:BER",
"name": "Berlin Brandenburg"
},
"destination": {
"id": "Station:airport:BCN",
"name": "Barcelona\u2013El Prat"
},
"return_time": null,
"departure_time": "2026-11-19T10:30:00",
"discount_percentage": null
}
],
"departure_date": "2026-11-19",
"filters_applied": [],
"total_available": 3
},
"meta": {
"billable": true,
"endpoint_family": "one_per_city"
},
"success": true
}Errors
Handle these documented responses before retrying or showing customer-facing failures.
Validation Error
A parameter is missing or invalid. This response is not billable.
{
"errors": {
"return_date": [
"Explore has no return date. Use nights_min and nights_max for a return trip."
]
},
"message": "The request validation failed"
}Upstream Unavailable
Kiwi.com did not answer in time. Retry the request. This response is not billable.
{
"meta": {
"billable": false,
"retryable": true,
"endpoint_family": "flight_search"
},
"error": {
"code": "UPSTREAM_UNAVAILABLE",
"message": "The Kiwi.com API is temporarily unavailable. Please retry."
},
"success": false
}Unexpected Upstream Answer
Kiwi.com answered in a form this API does not read. This response is not billable.
{
"meta": {
"billable": false,
"retryable": false,
"endpoint_family": "flight_search"
},
"error": {
"code": "PARSER_DRIFT",
"message": "Kiwi.com rejected the request. Check the parameters and try again."
},
"success": false
}Generate Code with AI
Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.
Try It Live
Test this endpoint in our interactive playground with real data.