Get Kiwi.com flight data fast, 100% accurate and super detailed — fares, bag fees and price calendars. Try it free, 1,000 free calls per month.

Search one-way flights: price, fare options, segments, layovers, bag fees, seats left and kiwi.com booking links.

Departure airport, city or country. Pass an IATA airport or city code, a Kiwi place id, a kiwi.com place slug (or a kiwi.com link containing it) or a plain place name; the form is detected for you, so no lookup call is needed first.

**Examples:**
- Airport: `JFK`
- City (all its airports): `NYC`
- Kiwi id: `City:new-york-city_ny_us`
- Slug: `new-york-city-new-york-united-states`
- Name: `new york`

origin

Arrival airport, city or country. Pass an IATA airport or city code, a Kiwi place id, a kiwi.com place slug (or a kiwi.com link containing it) or a plain place name; the form is detected for you, so no lookup call is needed first.

**Examples:**
- Airport: `JFK`
- City (all its airports): `NYC`
- Kiwi id: `City:new-york-city_ny_us`
- Slug: `new-york-city-new-york-united-states`
- Name: `new york`

destination

Departure date as `YYYY-MM-DD` (today or later).

**Default:** tomorrow

date

Last day of a flexible departure window: results cover every departure from `date` to `date_to`, as `YYYY-MM-DD`, at most 62 days after `date`.

date_to

Adult passengers.

**Default:** `1`

**Allowed values:** `1`-`9`

adults

Child passengers aged 2-11.

**Default:** `0`

**Allowed values:** `0`-`8`

children

Infants under 2 travelling on a lap, at most one per adult.

**Default:** `0`

**Allowed values:** `0`-`4`

infants

Cabin class to search.

**Default:** `economy`

**Allowed values:** `economy`, `premium_economy`, `business`, `first`

cabin_class

Cabin bags per passenger to price in. Fares that charge for a cabin bag include that fee in `price`.

**Default:** `0`

**Allowed values:** `0`-`1`

hand_bags

Checked bags per passenger to price in. Fares that charge for checked bags include those fees in `price`.

**Default:** `0`

**Allowed values:** `0`-`2`

checked_bags

Maximum stops per direction; `0` returns nonstop flights only.

**Allowed values:** `0`-`3`

max_stops

Maximum price per itinerary, in `currency`.

**Example:** `500`

max_price

Result order. `quality` is Kiwi.com's own best mix of price and duration.

**Default:** `quality`

**Allowed values:** `quality`, `price`, `duration`, `departure`, `arrival`, `popularity`

sort

Itineraries to return.

**Default:** `20`

**Allowed values:** `1`-`100`

limit

Comma-separated IATA airline codes. Keeps only itineraries flown entirely by these airlines.

**Example:** `B6,DL`

airlines

Comma-separated IATA airline codes to leave out of the results.

**Example:** `NK,F9`

exclude_airlines

Outbound departure time window as `start-end` hours of the local day (`0`-`24`).

**Example:** `6-12` (morning departures)

departure_hours

Outbound arrival time window as `start-end` hours of the local day (`0`-`24`).

**Example:** `12-20`

arrival_hours

Maximum total travel time per direction, in hours.

**Allowed values:** `1`-`120`

max_duration_hours

Maximum length of any layover, in hours.

**Allowed values:** `1`-`72`

max_layover_hours

Include Kiwi.com self-transfer itineraries: separate tickets combined into one trip, often far cheaper, protected by the Kiwi.com Guarantee. Each result says so in `is_self_transfer`.

**Default:** `true`

**Allowed values:** `true`, `false`

self_transfer

Include hidden-city and throwaway-ticket fares (flagged in `is_hidden_city` and `is_throwaway_ticket`).

**Default:** `true`

**Allowed values:** `true`, `false`

travel_hacks

Comma-separated transport types to combine.

**Default:** `flight`

**Allowed values:** `flight`, `bus`, `train`

transport

3-letter currency for every price.

**Default:** `USD`

**Allowed values:** any ISO 4217 code (`USD`, `EUR`, `GBP`, `CAD`, `INR`, ...)

currency

Language of airport, city and country names.

**Default:** `en`

**Allowed values:** any ISO 639-1 code (`en`, `es`, `de`, `fr`, `it`, ...)

locale

2-letter country of the Kiwi.com storefront whose fares and booking rules apply.

**Default:** `US`

**Allowed values:** any ISO 3166-1 alpha-2 code (`US`, `GB`, `CA`, `DE`, `IN`, ...)

market

Autocomplete airports, cities and countries by name or code: Kiwi id, IATA code, slug, timezone and coordinates.

Partial place name or IATA code to complete.

**Examples:**
- `las vegas`
- `san fr`
- `JFK`

query

Comma-separated place types to return.

**Default:** all types

**Allowed values:** `airport`, `city`, `country`, `region`, `continent`, `subdivision`, `bus_station`, `train_station`, `point_of_interest`, `tourist_region`

types

Places to return.

**Default:** `10`

**Allowed values:** `1`-`50`

Las Vegas

Harry Reid International Airport

United States

Northern America

Nevada

Search round-trip flights by dates, flexible windows or stay length: both directions, bags, stay and booking links.

Return date as `YYYY-MM-DD`, on or after `date`. Leave it out and pass `nights_min` for a stay-length search instead.

**Default:** a week after `date`

return_date

Instead of `return_date`: shortest stay in nights. Kiwi.com then picks the best return day for every stay length in range.

**Allowed values:** `0`-`365`

nights_min

Longest stay in nights, with `nights_min`.

**Default:** `nights_min`

**Allowed values:** `0`-`365`

nights_max

Last day of a flexible return window (`return_date` to `return_date_to`), as `YYYY-MM-DD`, at most 62 days after `return_date`.

return_date_to

Search a 2-6 leg trip: every leg's itineraries with price, segments, layovers and bags, plus the cheapest total.

The trip as a JSON array of 2-6 legs in travel order, each with `origin`, `destination` and an optional `date` (`YYYY-MM-DD`). Places take every form `origin` accepts. A leg without a date departs 3 days after the previous one; the first defaults to tomorrow.

**Example:** `[{"origin":"NYC","destination":"LON","date":"2026-12-10"},{"origin":"LON","destination":"PAR"}]`

legs

Re-price one itinerary by its id or kiwi.com share link: price, fares, every segment, layovers, bag tiers, booking link.

The `id` of any itinerary a search returned (Kiwi.com's share id), an `ItineraryOneWay:` / `ItineraryReturn:` id, or a kiwi.com link carrying `?shareId=`. The flight is re-priced live, so you get today's price and seats.

**Examples:**
- Share id: `eyJyIjoiQjY6MTEwNzpKRks6…`
- Link: `https://www.kiwi.com/en/booking/?shareId=eyJyIjoiQjY6MTEwNzpKRks6…`

itinerary

Kiwi.com

London

United Kingdom

Heathrow

New York

John F. Kennedy International

JetBlue Airways

Find the cheapest places to fly from a city: the lowest fare per destination with departure, return and stay length.

`one_way` prices single flights; `round_trip` prices a return trip for a stay of `nights_min`-`nights_max` nights.

**Default:** `one_way`

**Allowed values:** `one_way`, `round_trip`

trip_type

Earliest departure date as `YYYY-MM-DD`.

**Default:** tomorrow

date_from

Latest departure date as `YYYY-MM-DD`, at most 365 days after `date_from`.

**Default:** 30 days after `date_from`

Round trips: shortest stay in nights.

**Default:** `3`

**Allowed values:** `0`-`365`

Round trips: longest stay in nights.

**Default:** `7`

**Allowed values:** `0`-`365`

Maximum fare, in `currency`.

**Example:** `200`

Maximum stops per direction; `0` keeps nonstop routes only.

**Allowed values:** `0`-`3`

Destination cities to return.

**Default:** `30`

**Allowed values:** `1`-`100`

Fort Lauderdale

Fort Lauderdale–Hollywood International

New York Stewart International Airport

Atlanta

Hartsfield–Jackson Atlanta International

Newark Liberty International

Toronto

Canada

Billy Bishop Toronto City

Orlando

Orlando International

LaGuardia

Dallas

Dallas/Fort Worth International

San Juan

Luis Muñoz Marín International

Aruba

Queen Beatrix International

Fort Myers

Southwest Florida International

Tampa

St. Pete–Clearwater International

West Palm Beach

President Donald J. Trump International Airport

Punta Cana

Dominican Republic

Punta Cana International

Houston

George Bush Intercontinental

Montego Bay

Jamaica

Sangster International

Cancún

Mexico

Cancún International

San Francisco

San Francisco International

Los Angeles

Los Angeles International

Miami

Miami International

San Diego

San Diego International

Santo Domingo

Las Américas International

Phoenix

Phoenix Sky Harbor International

Santiago de los Caballeros

Cibao International

Mexico City

Mexico City International

Madrid

Spain

Adolfo Suárez Madrid–Barajas

Paris

France

Charles de Gaulle Airport

Rome

Italy

Leonardo da Vinci–Fiumicino Airport

Dubai

United Arab Emirates

Dubai International

Tel Aviv

Israel

Ben Gurion

Tokyo

Japan

Haneda

Get the cheapest one-way fare for every departure day between two places, rated cheap, average or expensive.

First departure date to price, as `YYYY-MM-DD`.

**Default:** today

Last departure date to price, as `YYYY-MM-DD`, at most 92 days after `date_from`.

**Default:** 30 days after `date_from`

Get the cheapest round-trip fare for every departure day at a set stay length, rated cheap, average or expensive.

Shortest stay in nights.

**Default:** `7`

**Allowed values:** `0`-`365`

Longest stay in nights.

**Default:** `nights_min`

**Allowed values:** `0`-`365`

Get the price curve between two places: the cheapest fare per departure day, with its return date for round trips.

First departure date of the curve, as `YYYY-MM-DD`.

**Default:** today

Last departure date of the curve, as `YYYY-MM-DD`, at most 92 days after `date_from`.

**Default:** 30 days after `date_from`

Round-trip curve: shortest stay in nights. Omit it for a one-way curve.

**Allowed values:** `0`-`365`

Round-trip curve: longest stay in nights.

**Default:** `nights_min`

**Allowed values:** `0`-`365`

Get the round-trip price for one departure and return date pair, rated cheap, average or expensive.

Return date as `YYYY-MM-DD`, on or after `date`.

**Default:** a week after `date`

Get the cheapest fare to up to 25 cities inside a map box from one origin: ranked, with city details and coordinates.

Map box to price, as `sw_lat,sw_lng,ne_lat,ne_lng` (south-west corner, then north-east corner). Kiwi.com returns up to 25 cities per box, so split a large area into tiles for more.

**Default:** the whole world

**Example:** `35,-10,60,30` (Europe)

bounds

Round trips: earliest return date as `YYYY-MM-DD`. Without a return window, `nights_min` or `return_anytime`, prices are one-way.

return_from

Round trips: latest return date as `YYYY-MM-DD`, with `return_from`.

**Default:** 30 days after `return_from`

return_to

Round trips, instead of return dates: shortest stay in nights.

**Allowed values:** `0`-`365`

Round trips: longest stay in nights.

**Default:** `nights_min`

**Allowed values:** `0`-`365`

Set `true` for round-trip prices with any return date.

**Default:** `false`

**Allowed values:** `true`, `false`

Place Details