Find the Best Flight Prices
Search across airlines and routes to find the cheapest flights for your travel dates and destination.
Flight Search
Live flights with prices & baggage
Search live flight inventory across airlines for any route. Get real-time pricing, baggage, emissions, stops, and booking deadlines for one-way or round-trip flights. Supports economy through first class, up to 9 passengers. Returns IDs needed for booking handoff.
Search Flights
Search for flight offers between two airports. Returns prices, airlines, departure and arrival times, duration, number of stops, baggage, emissions, and booking deadlines for each offer.
Returns: List of flight offers with airlines, departure/arrival times, duration, stops, prices, baggage, emissions, and booking deadlines
Parameters
origin *stringOrigin airport or city IATA code (e.g. 'LHR', 'NYC', 'SYD')
destination *stringDestination airport or city IATA code
departure_date *stringDeparture date in YYYY-MM-DD format
return_datestringReturn date for round-trip (omit for one-way)
adultsnumberNumber of adult passengers (1-9)
childrennumberNumber of children (2-11 years)
cabin_classstringCabin class preference
max_connectionsnumberMaximum number of stops (0 for direct only, 1-2 for connections)
max_resultsnumberMaximum number of offers to return
Example
One-way flight from London to New York
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "flight-search",
"skill": "search_flights",
"input": {
"origin": "LHR",
"destination": "JFK",
"departure_date": "2026-04-15"
}
}' \
https://api.toolrouter.com/v1/tools/callFind Airport
Search for airport or city IATA codes by name. Useful when you know the city or airport name but need the IATA code for flight searches.
Returns: Matching airports and cities with IATA code, name, city, country, coordinates, and timezone
Parameters
query *stringAirport name, city name, or IATA code to search for
Example
Find airports in London
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "flight-search",
"skill": "find_airport",
"input": {
"query": "London"
}
}' \
https://api.toolrouter.com/v1/tools/callGet Offer Details
Get refreshed details for a specific flight offer by its ID. Returns updated pricing, baggage info, available services, and booking deadline. Use this after search_flights to check if an offer is still available.
Returns: Refreshed offer details with updated pricing, baggage, emissions, and booking deadline
Parameters
offer_id *stringOffer ID from search_flights results (e.g. 'off_0000...')
Example
Get details for a specific offer
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{
"tool": "flight-search",
"skill": "get_offer",
"input": {
"offer_id": "off_0000AEdHh0OlkSORal"
}
}' \
https://api.toolrouter.com/v1/tools/callQuick Start
MCP (Claude Code)
claude mcp add --transport stdio \
--env TOOLROUTER_API_KEY=YOUR_API_KEY \
toolrouter -- npx -y toolrouter-mcpREST API
curl -H "Authorization: Bearer $TOOLROUTER_API_KEY" \
-d '{"tool":"flight-search","skill":"search_flights","input":{}}' \
https://api.toolrouter.com/v1/tools/callUse Cases
Compare Airline Routes and Connections
Analyze different routing options between cities including direct flights, connections, and alternative airports.
Search Papers by Topic
Find relevant academic papers on any research topic across millions of scholarly publications.
Geocode Addresses to Coordinates
Convert street addresses into precise latitude and longitude coordinates for mapping and spatial analysis.
Workflows
Travel Planning Assistant
Plan a complete trip from flights and hotels to weather, currency, and local events in one workflow.
Business Trip Planner
Plan business trips with flights, hotels, currency conversion, weather, and timezone alignment.
Frequently Asked Questions
Do I need airport codes before searching flights?
Not necessarily. Use `find_airport` if you only have a city or airport name, then pass the IATA codes into `search_flights`.
What does a flight search return?
`search_flights` returns live offers with airlines, departure and arrival times, duration, stops, baggage, emissions, and booking deadlines.
Can I look for direct flights or specific cabin classes?
Yes. Set `max_connections` to `0` for direct-only results, and choose the cabin class you want, from economy through first class.
How do I get refreshed pricing before booking?
Use `get_offer` on a specific offer ID to refresh the price and confirm availability. The search response also includes the IDs needed for booking handoff.