docs / flights

Flights

Search flights with prices, routes and times.

base /flights/v12 endpoints

post/flights/v1/search_flights2 credits

Search flights from origin to destination for a given date. Returns ranked itineraries with price, all flight segments (carrier, flight number, departure/arrival times), total journey duration and a direct booking link. Supports one-way and return trips.

Parameter		Allowed / range	Description
origin	required	—	Departure: IATA code (LON/JFK), city name, or Kiwi location id.
destination	required	—	Arrival: IATA code, city name, or Kiwi location id.
depart_date	required	—	Outbound date, YYYY-MM-DD (must be a future date).
return_date	optional	—	Return date, YYYY-MM-DD. Omit for a one-way search.
depart_date_end	optional	—	End of an outbound date RANGE (YYYY-MM-DD); search any departure between depart_date and this.
return_date_end	optional	—	End of a return date RANGE (YYYY-MM-DD).
adults = 1	optional	0–	Number of adult passengers.
children = 0	optional	0–	Number of child passengers (2-11).
infants = 0	optional	0–	Number of infant passengers (<2).
cabin_class = economy	optional	economy · premium_economy · business · first	Cabin class (unknown values fall back to economy).
currency = USD	optional	—	ISO-4217 currency for prices (e.g. USD, EUR, GBP). Default USD.
max_stops	optional	0–	Max number of stops (0 = direct only). Omit for any.
sort = price	optional	price · duration · quality · date · popularity	Result ordering (unknown values fall back to price).
limit = 20	optional	1–	Max itineraries to return (default 20).

Try in playground →

post/flights/v1/search_places1 credit

Resolve a city or airport name to location IDs used in flight search — useful when you want to pin an exact airport rather than a city (e.g. 'Heathrow' → LHR).

Parameter		Allowed / range	Description
query	required	—	City or airport name / IATA code to resolve to Kiwi place ids.
limit = 8	optional	1–	Max place matches to return (default 8).

Try in playground →

Example request · search_flights

curl -X POST https://api.reefapi.com/flights/v1/search_flights \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"origin":"London","destination":"New York","depart_date":"2026-07-13","limit":5}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}