API Documentation
Get Hubs
Returns a list of all airport hubs configured in the application.
Endpoint: /api/hubs
Source: Internal application configuration.
Success Response (200): A JSON array of hub objects.
Click the button to load data...
Get Airport Info (Proxy)
Proxies a request to aviationweather.gov
to fetch public data for a given airport by its ICAO code. This is used to bypass browser CORS restrictions when adding a new airport.
Endpoint: GET /api/airport-info/<icao>
Source: Aviation Weather Center Data API.
Parameters:
icao
(string, required): The 4-letter ICAO code of the airport (e.g., KPIA).
Success Response (200): A JSON array containing airport data object(s).
Click the button to load data...
Get Weather Data
Returns weather data for a specific hub. For the current day, it fetches live data. For past dates, it returns archived data.
Endpoint: GET /api/weather/<iata>
Source: National Weather Service (NWS) API and FAA National Airspace System Status.
Parameters:
iata
(string, required): The IATA code of the hub (e.g., CLT, DFW).date
(string, optional): A date in YYYY-MM-DD format to retrieve archived data.
Success Response (200): A JSON object containing hourly and daily forecasts, timezone, and FAA data.
Click the button to load data...
Get Hourly Snapshots
Returns all hourly data snapshots for a given hub and date from the archive.
Endpoint: GET /api/hourly-snapshots/<iata>/<date>
Source: Internal application database archive. Data is originally sourced from NWS and FAA APIs.
Parameters:
iata
(string, required): The IATA code of the hub.date
(string, required): A date in YYYY-MM-DD format.
Success Response (200): A JSON array of snapshot objects for each hour.
Click the button to load data...
Get Ground Stops
Returns active ground stops for all hubs from the FAA.
Endpoint: GET /api/groundstops
Source: FAA National Airspace System Status API.
Success Response (200): A JSON object where keys are IATA codes and values are the reason for the ground stop.
Click the button to load data...
Get Available Archive Dates
Returns a list of all dates for which there is archived data available.
Endpoint: GET /api/archive-dates
Source: Internal application database archive.
Success Response (200): A JSON array of date strings in YYYY-MM-DD format.
Click the button to load data...