Search cheapest flights
search_flightsSearch cheap flights between two airports or cities and return the cheapest all-in fare plus a cheapest-sensible alternative (penalises 20h+ layovers and risky overnight transfers). Compares Kiwi.com live fares with Duffel and Aviasales data, expands nearby airports and combines self-transfer one-ways when cheaper. Strong on Africa routes (Abidjan, Dakar, Lagos, Accra, Nairobi, Casablanca). One-way, return, multi-passenger, cabin and bag filters. Example: {"origin":"ABJ","destination":"CDG","departureDate":"2026-12-18","returnDate":"2027-01-05","flexDays":3,"currency":"XOF"}. Returns {cheapest, cheapestSensible, offers[], sources, notes}.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"origin": "<origin>",
"destination": "<destination>",
"departureDate": "<departureDate>"
},
"name": "search_flights"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max offers returned. Default 20. | |
| adults | No | Adults (12+). Default 1. | |
| origin | Yes | Departure airport or city: a 3-letter IATA airport/metro code (ABJ, DSS, LOS, CDG, LON, NYC) or a plain name ("Abidjan", "Paris"). | |
| infants | No | Infants on lap (<2). Default 0. | |
| children | No | Children (2–11). Default 0. | |
| currency | No | ISO 4217 display currency. Default EUR. XOF is shown as FCFA. | |
| flexDays | No | Also search ± this many days around the dates. 3 finds the cheapest fare that exists. | |
| maxStops | No | Maximum stops per direction. 0 = direct only. | |
| cabinClass | No | Cabin. Default economy. | |
| returnDate | No | Return date YYYY-MM-DD. Omit for one-way. | |
| destination | Yes | Arrival airport or city: a 3-letter IATA airport/metro code (ABJ, DSS, LOS, CDG, LON, NYC) or a plain name ("Abidjan", "Paris"). | |
| departureDate | Yes | Outbound date, YYYY-MM-DD. | |
| nearbyAirports | No | Include metro and alternate airports (LON, PAR, NYC, DKR/DSS, LOS/ABV, ACC/KMS). Default true. | |
| allowSelfTransfer | No | Allow self-transfer itineraries. Default true. | |
| stitchSelfTransfer | No | Combine one-way tickets through hubs (CMN, LFW, LIS, IST…) when cheaper. Default true. | |
| checkedBagsPerAdult | No | Checked bags per adult to price in. Default 0. |