get_airport_schedule
Retrieve real-time departure and arrival boards for any airport. Filter by airline or flight number to see live times and status.
Instructions
TRIGGER: use automatically whenever the user asks what flights leave/arrive at an airport, or about departures/arrivals 'today / now / soon / in the next hours', or which destinations an airline serves from an airport right now — even without naming AirLabs. Get the LIVE departures/arrivals board for an airport (real-time, up to ~10 hours ahead). Each row has dep_time/arr_time, dep_estimated/arr_estimated, status, terminal, gate, delay, airline and flight number. THIS is the tool for questions about WHEN flights leave/arrive 'today' / 'soon' / 'right now'. USE CASES: 'What flights leave JFK today?', 'Show Wizz Air departures from Sofia in the next hours', 'Arrivals at LHR now'. INPUT: query by dep_iata (departures) OR arr_iata (arrivals). You may ADD airline_iata to filter by carrier, and/or flight_iata to list every instance of a number. WORKFLOW for 'Which airports does fly to from soon?':
get_airline_info(name='') -> airline IATA code (e.g. Wizz Air -> W6)
search_airport_code(q='') -> airport IATA code (e.g. Sofia -> SOF)
get_airport_schedule(dep_iata='SOF', airline_iata='W6') -> live departures w/ times
(optional) get_airport_info(iata_code=) -> full destination names Do NOT use find_routes for 'soon/today' — that returns a weekly timetable without live times. Use this tool when the user cares about actual times. TIME WINDOW & STATUS: the board covers a window from the recent past to several hours ahead, so it mixes flights that have not left yet, are airborne, and have already departed/landed. Each row's 'status' tells which: scheduled = not departed yet, active = airborne, landed = arrived (and 'cancelled'). Interpret the user's intent and filter the rows accordingly when their wording is specific: for 'upcoming / still to depart / next few hours' keep status=scheduled with a future dep_estimated/dep_time; for 'already left / departed' keep active/landed. If the user is NOT specific, do NOT drop rows — show them and label each with its status and time. Never silently hide matching flights; if filtering leaves nothing, say so and report what the board does contain.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max rows (airport: up to 1000; airline: 200; free keys: 50). | |
| _fields | No | Comma-separated fields to keep responses small, e.g. 'flight_iata,arr_iata,dep_time,dep_estimated,status'. | |
| arr_iata | No | Arrival airport IATA code, e.g. 'LHR'. | |
| arr_icao | No | Arrival airport ICAO code, e.g. 'EGLL'. | |
| dep_iata | No | Departure airport IATA code, e.g. 'SOF' (Sofia), 'JFK'. | |
| dep_icao | No | Departure airport ICAO code, e.g. 'LBSF'. | |
| flight_iata | No | List every instance of this flight IATA number. | |
| flight_icao | No | List every instance of this flight ICAO number. | |
| airline_iata | No | Filter the board by airline IATA code, e.g. 'W6' (Wizz Air). | |
| airline_icao | No | Filter the board by airline ICAO code, e.g. 'WZZ'. |