{"aircraft":{"path":"/aviation/aircraft","method":"GET","kind":"data","tier":"basic","description":"Aircraft specifications lookup by ICAO type designator with performance data.","parameters":{},"required":[],"output_example":{"type":"B738","name":"Boeing 737-800","cruise_speed_kmh":852,"range_km":5438,"wtc":"M","engine_type":"Jet"},"latency_class":"fast"},"airport":{"path":"/aviation/airport","method":"GET","kind":"data","tier":"basic","description":"Airport information — ICAO lookup including runways, frequencies, and services.","parameters":{"icao":{"type":"string","description":"ICAO airport code (e.g. EGLL, KLAX, LFPG)"}},"required":["icao"],"output_example":{"icao":"EGLL","iata":"LHR","name":"London Heathrow Airport","state":"England","country":"GB","latitude":51.4706,"longitude":-0.4619,"elevation_m":25.3,"magnetic_variation":"1.5W","type":"large_airport","runways":[{"id":"09L/27R","dimensions":"12000x148 ft","surface":"Asphalt","alignment":90}],"frequencies":[{"type":"TWR","frequency":"118.500"}],"services":["fuel","repairs"]},"latency_class":"fast"},"flights":{"path":"/aviation/flights","method":"GET","kind":"data","tier":"basic","description":"Live aircraft positions near a location (ADS-B, global).","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"},"radius_km":{"type":"integer","description":"Search radius in km","default":100}},"required":["latitude","longitude"],"output_example":{"location":{"lat":51.5,"lon":-0.12,"radius_km":100},"flights":[{"callsign":"BAW123","origin_country":"United Kingdom","latitude":51.47,"longitude":-0.45,"altitude_m":11582.4,"heading":217.7,"velocity_kmh":850.0,"icao24":"39de53"}],"count":1},"latency_class":"fast"},"gairmets":{"path":"/aviation/gairmets","method":"GET","kind":"data","tier":"basic","description":"Graphical AIRMETs (G-AIRMETs) — icing, turbulence, and IFR condition advisories.","parameters":{},"required":[],"output_example":{"count":1,"gairmets":[{"hazard":"ICE","forecast_hour":0,"valid_time":"2026-06-18T10:00:00Z","severity":"moderate","area_coords":[[35.0,-85.0],[36.0,-84.0],[37.0,-83.0]],"top":18000,"base":5000}]},"latency_class":"fast"},"jetstream":{"path":"/aviation/jetstream","method":"GET","kind":"data","tier":"basic","description":"Multi-level upper atmosphere wind and temperature data from 850hPa through 200hPa.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"}},"required":["latitude","longitude"],"output_example":{"location":{"lat":51.5,"lon":-0.12},"upper_atmosphere":{"levels":{"850hPa":{"temp_c":12.0,"wind_speed_kmh":25.2,"wind_direction":220},"700hPa":{"temp_c":5.0,"wind_speed_kmh":40.0,"wind_direction":240},"500hPa":{"temp_c":-10.0,"wind_speed_kmh":60.0,"wind_direction":250,"geopotential_height_m":5600},"300hPa":{"temp_c":-35.0,"wind_speed_kmh":90.0,"wind_direction":260},"250hPa":{"temp_c":-50.0,"wind_speed_kmh":111.6,"wind_direction":250},"200hPa":{"temp_c":-57.0,"wind_speed_kmh":100.0,"wind_direction":255}}}},"latency_class":"fast"},"notams":{"path":"/aviation/notams","method":"GET","kind":"data","tier":"basic","description":"Active NOTAMs (Notices to Air Missions) for an airport — with ICAO-formatted messages, plain-language text, and parsed fields.","parameters":{"icao":{"type":"string","description":"ICAO airport code (e.g. KJFK, EGLL, KLAX)"}},"required":["icao"],"output_example":{"icao":"KJFK","airport_name":"John F Kennedy Intl","total_notams":155,"notams":[{"notam_id":"KJFK 04/137","type":"Obstruction","raw_icao":"04/137 NOTAMN Q) KZNY/QOBXX/...","plain_text":"CRANE (ASN 2024-AEA-10579-OE) 404003N0734744W ... FLAGGED AND LGTD","start_date":"04/07/2025 1133","end_date":"07/06/2026 1800","status":"Active"}]},"latency_class":"fast"},"pireps":{"path":"/aviation/pireps","method":"GET","kind":"data","tier":"basic","description":"Pilot Reports (PIREPs) near a station — aircraft type, flight level, weather, icing, and turbulence reports.","parameters":{"icao":{"type":"string","description":"ICAO airport code (e.g. KLAX, EGLL)"},"distance":{"type":"integer","description":"Search radius in nautical miles","default":200,"maximum":500},"hours":{"type":"integer","description":"Hours back to search","default":6,"maximum":24}},"required":["icao"],"output_example":{"icao":"KLAX","distance":200,"hours":6,"pireps":[{"receiptTime":"2026-06-18T12:00:00Z","aircraft_type":"B738","flight_level":"FL350","lat":33.94,"lon":-118.41,"temp_c":-50,"wind_dir":260,"wind_speed_kt":45,"icing":"light","turbulence":"moderate","raw_text":"UA /OV LAX090030 /TM 1200 /FL350 /TP B738 /SK OVC /TA -50 /WV 26045 /TB MOD /IC LGT"}],"count":1},"latency_class":"fast"},"route":{"path":"/aviation/route","method":"GET","kind":"data","tier":"basic","description":"Route distance and estimated flight time between two airports — with optional aircraft type lookup.","parameters":{"from":{"type":"string","description":"Departure ICAO airport code (e.g. EGLL)"},"to":{"type":"string","description":"Arrival ICAO airport code (e.g. KJFK)"}},"required":["from","to"],"output_example":{"from":"EGLL","to":"KJFK","from_airport":"London Heathrow Airport","to_airport":"John F Kennedy Intl","distance_km":5550.5,"distance_nm":2997.0,"aircraft_type":"B738","cruise_speed_kmh":852,"estimated_flight_time_hours":6.5,"estimated_flight_time_label":"6h 30m"},"latency_class":"fast"},"sigmets":{"path":"/aviation/sigmets","method":"GET","kind":"data","tier":"basic","description":"Significant Meteorological Information (SIGMETs) — domestic and international convective, turbulence, and icing advisories.","parameters":{},"required":[],"output_example":{"sigmet_count":2,"sigmets":[{"type":"domestic","hazard":"CONVECTIVE","severity":"severe","valid_from":"2026-06-18T10:00:00Z","valid_to":"2026-06-18T14:00:00Z","location":"Within 40NM of 35N 85W","raw_text":"WSUS31 KKCI 181000 SIGA CONVECTIVE..."}]},"latency_class":"fast"},"weather":{"path":"/aviation/weather","method":"GET","kind":"data","tier":"basic","description":"Aviation weather (METAR + TAF) at an airport.","parameters":{"icao":{"type":"string","description":"ICAO airport code (e.g. EGLL, KLAX, LFPG)"}},"required":["icao"],"output_example":{"icao":"EGLL","metar":{"raw":"METAR EGLL 180550Z AUTO 22006KT 190V250 9999 OVC009 18/16 Q1018","temp_c":18,"dewpoint_c":16,"wind_dir":220,"wind_speed_kt":6,"visibility":"6+","altimeter_hpa":1018},"taf":{"raw":"TAF AMD EGLL 180525Z 1806/1912 20010KT 9999 BKN008 ...","issue_time":"2026-06-18T05:25:00Z","valid_from":"2026-06-18T06:00:00Z","valid_to":"2026-06-19T12:00:00Z"}},"latency_class":"fast"},"winds":{"path":"/aviation/winds","method":"GET","kind":"data","tier":"basic","description":"Winds aloft at multiple pressure levels (850hPa through 200hPa) — temperature, wind speed, and direction at each level.","parameters":{"latitude":{"type":"number","description":"Latitude (-90 to 90)"},"longitude":{"type":"number","description":"Longitude (-180 to 180)"}},"required":["latitude","longitude"],"output_example":{"location":{"lat":51.5,"lon":-0.12},"winds_aloft":{"850hPa":{"temp_c":12.0,"wind_speed_kmh":25.2,"wind_direction":220},"700hPa":{"temp_c":5.0,"wind_speed_kmh":40.0,"wind_direction":240},"500hPa":{"temp_c":-10.0,"wind_speed_kmh":60.0,"wind_direction":250},"300hPa":{"temp_c":-35.0,"wind_speed_kmh":90.0,"wind_direction":260},"250hPa":{"temp_c":-50.0,"wind_speed_kmh":111.6,"wind_direction":250},"200hPa":{"temp_c":-57.0,"wind_speed_kmh":100.0,"wind_direction":255}}},"latency_class":"fast"},"ask":{"path":"/aviation/ask","method":"POST","kind":"inference","tier":"regular","description":"Premium multi-source aviation intelligence: ask natural-language questions about flights, aviation weather (METAR/TAF), jet streams, and airports. Returns a reasoned answer by synthesising multiple live data sources in parallel.","parameters":{"question":{"type":"string","description":"Natural language aviation question."},"icao":{"type":"string","description":"ICAO airport code — optional."},"latitude":{"type":"number","description":"Latitude — optional, extracted from question if omitted."},"longitude":{"type":"number","description":"Longitude — optional, extracted from question if omitted."}},"required":["question"],"output_example":{"question":"What's the weather at Heathrow?","answer":"Current METAR: wind 220/6kt, 18°C, OVC009 at 900ft. TAF: becoming 200/10kt 9999.","sources_consulted":["Weather Data","Flight Tracking","Upper Atmosphere Data"],"reasoning_model":"deepseek-v4-flash"},"latency_class":"medium"}}