Endpoints refer to the types of data to request, such as a place, observation, forecast or advisory, and will be the basis for any request made to the weather API. The following endpoints are currently supported within Aeris.
To query multiple endpoints with a single weather API request review the Batch Requests feature.
All endpoints support the Schema Action, which will return the JSON specification for the endpoint.
Filter by Subscription
| Endpoint | Description | Actions |
|---|---|---|
| airquality |
Air Quality Index which provides pollutant data around the world. Data CoverageGlobal Included With API Developer, API Premium |
:id closest within search route |
| airquality/forecasts | Currently in BETA Future Air Quality Index around the globe including each individual pollutant. Data CoverageGlobal Included With API Developer, API Premium |
:id |
| alerts |
Mild to severe weather events issued to the public from the Canadian and US government. Data CoverageUSA, Canada Included With API Developer, API Basic, API Premium |
:id closest within search |
| alerts/summary |
Summary of active weather events across Canada and US. This endpoint is derived from the /alerts endpoint. Data CoverageUSA, Canada Included With API Developer, API Premium |
:id search within |
| convective/outlook |
SPC’s outlook for convective activity across the US. This includes the SPC’s convective, hail, tornado, wind, and thunderstorm product. Data CoverageContinental US Included With API Developer, API Premium |
:id affects contains search |
| countries |
Geographical data related to countries around the world. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id search |
| droughts/monitor |
Official drought areas per the National Drought Mitigation Center. Data CoverageContinental US Included With API Developer, API Premium |
:id affects contains search |
| earthquakes |
Global earthquake data including magnitude, depth, and type. Data CoverageGlobal Included With API Developer, API Premium |
:id closest within search affects |
| fires |
Wildfires across the U.S. with data including type, cause, area, and percent contained. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| fires/outlook |
SPC’s outlook for weather conditions that will promote the spread of fires. Data CoverageContinental US Included With API Developer, API Premium |
:id affects contains search within |
| forecasts |
Future weather conditions around the globe. We support daily, hourly, and many other forecast intervals. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id route |
| indices |
Global index for a variety of health and outdoor activities. Endpoint can provide current and forecast indices. Data CoverageGlobal Included With API Developer, API Premium |
:id route closest |
| lightning |
Global lightning data based on a location queries. Endpoint provides data such as amperage, type of strike, and strike height. Data CoverageGlobal Included With API Developer, API Premium |
:id closest search |
| lightning/summary |
A summary of lightning strikes that took place across the globe. Search can also be narrowed down by a specific country or state. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest search within |
| normals |
The 30-year climate normals collected by NOAA across the United States. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| normals/stations |
Stations associated with collecting the climate data for the /normals endpoint. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| observations |
Current conditions provided by the closest weather station. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest within search route |
| observations/archive |
Historical observations by day dating back to 2011. Data CoverageGlobal Included With API Developer, API Premium |
:id closest within search |
| observations/summary |
Daily summaries based on previously recorded observations. Daily summaries can go back as far as 2011. Data CoverageGlobal Included With API Developer, API Premium |
:id closest search within |
| phrases/summary |
Phrase related to the current and expected conditions for the next several hours. Data CoverageGlobal Included With API Developer, AMP Basic, API Premium |
:id |
| places |
Geographical information for a given location. Including elevation, population, region, country, continent, etc. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest within search |
| places/airports |
Geographical information about airports around the world. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest within search |
| places/postalcodes |
Provides geographical information for US and Canadian postal codes. Data CoverageUSA, Canada Included With API Developer, API Basic, API Premium |
:id closest within search |
| records |
Daily records set in the U.S. that are transmitted by the National Weather Service. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| rivers |
U.S. lake and river gauges collected and distributed by NOAA’s AHPS department. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| rivers/gauges |
Enhanced data from rivers and lake gauges per the /rivers endpoint. Data includes recent crests, historical crests, and flood impacts. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest search within |
| stormcells |
Observed storm cells and their forecast tracks per the NEXRAD radar system in the U.S. Data will include general, hail, rotating, and tornadic storm cells. Data CoverageContinental US, Alaska, Hawaii, Puerto Rico, Guam Included With API Developer, API Premium |
:id closest within search affects |
| stormcells/summary |
A summary of active storm cells per the /stormcells endpoint. Data CoverageContinental US, Alaska, Hawaii, Puerto Rico, Guam Included With API Developer, API Premium |
:id affects search within |
| stormreports |
Local storm reports transmitted by the National Weather Service in the U.S. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| stormreports/summary |
A summary of storm reports derived from the /stormreports endpoint. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id search within |
| sunmoon |
Global sun and moon rise / set data. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id |
| sunmoon/moonphases |
Current phase of the moon. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id search contains |
| threats |
Localized threat summary based on the location provided. Endpoint currently supports U.S. locations. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id |
| tides |
Current and forecast tide levels for US coasts. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| tides/stations |
General information about a specific tides station. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| tropicalcyclones | Currently in BETA Provides information on active tropical cyclones across the globe. Data CoverageGlobal Included With API Developer, API Premium |
:id closest search within affects |
| tropicalcyclones/archive | Currently in BETA Provides archive information on global tropical cyclones. Data CoverageGlobal Included With API Developer, API Premium |
:id closest search within affects |
| version |
Weather API current version. Included With API Developer, API Basic, API Premium |
|
| winter/snowdepth |
Estimated snow depth across North America. Data CoverageContinental US, Canada Included With API Developer, API Premium |
:id closest |