Search current/live flights, optionally filtered by route, airline, or status.

IMPORTANT: this returns CURRENT and near-term real-time flights only — it cannot search a future travel date (e.g. "flights on Sept 20th") or historical flights, and it does not include prices. For a specific flight's status, use get_flight_status instead.

Args: origin: Optional 3-letter IATA departure airport code (e.g. "JFK"). destination: Optional 3-letter IATA arrival airport code (e.g. "LHR"). airline_name: Optional airline name to filter by (e.g. "American Airlines"). flight_status: Optional status filter: scheduled, active, landed, cancelled, incident, or diverted. max_results: Max number of results to return (1-100, default 10).

Provide at least one filter (origin, destination, or airline_name) — an unfiltered call returns an arbitrary global sample and burns quota fast.

Get the real-time status of a specific flight by its IATA flight code.

Args: flight_iata: IATA flight code, e.g. "AA100" (airline code + flight number).

Returns current status (scheduled/active/landed/cancelled/etc.), gate, terminal, delay, and live position if airborne.

Look up IATA airport codes by city or airport name.

Args: keyword: City or airport name, or exact IATA code (e.g. "London", "Heathrow", "JFK"). Minimum 2 characters. max_results: Max number of matches to return (1-20, default 10).

Use this before search_flights if you only have a city/airport name rather than a 3-letter IATA code.

Look up airline IATA codes by airline name.

Args: keyword: Airline name or partial name (e.g. "American", "Emirates"), or exact IATA code (e.g. "AA"). Minimum 2 characters. max_results: Max number of matches to return (1-20, default 10).