docs / flights

Flights

Search flights with prices, routes and times.

base /flights/v12 endpoints

post/flights/v1/search_flights2 credits

flight search: `origin` + `destination` (city name OR IATA) + `depart_date` (+ optional `return_date`) → flights[]{price{amount,currency}, segments[]{carrier,carrier_code,flight_no,departure,arrival}, duration_seconds, booking_url, origin, destination}. One-way or return (outbound/inbound legs). `limit` caps results.

Parameter	Required
origin	required
destination	required
depart_date	required
return_date	optional
limit	optional

Try in playground →

post/flights/v1/search_places1 credit

resolve a city/airport `query` → Kiwi place ids → places[]{id,name,type} (use for origin/destination resolution).

Parameter	Required
query	required

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-07","limit":5}'

Response shape

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