Our subscriptions have changed. Upgrade to AerisWeather Flex (API + Maps) to access all available features, including historical data, and to add lightning to your active subscription, select our Lightning Add-On. Contact our team with any questions or to migrate offline contracts. Legacy plans will continue to have access to the select endpoints and layers included in their original plans.
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 AerisWeather.
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.
| Endpoint | Description | Actions |
|---|---|---|
| airquality |
Air Quality Index which provides pollutant data around the world. Data CoverageGlobal Included WithAPI, Flex, |
:id closest within search route |
| airquality/forecasts |
Future Air Quality Index around the globe including each individual pollutant. Data CoverageGlobal Included WithFlex, API, |
:id |
| alerts |
Mild to severe weather events issued to the public from the Canadian and US government. Data CoverageUSA, Canada, Europe Included WithAPI, Flex, Update IntervalReal Time |
:id route |
| alerts/summary |
Summary of active weather events across Canada and US. This endpoint is derived from the /alerts endpoint. Data CoverageUSA, Canada, Europe Included WithAPI, Flex, |
:id search within |
| conditions |
Global current, forecast, and past conditions for a specific date/time or in hourly intervals. Minutely precipitation forecasts are also available. Data CoverageGlobal Included WithAPI, Flex, Update IntervalNear Real Time |
:id route |
| conditions/summary |
Global current and past conditions as a daily summary or a summary in specified intervals. Data CoverageGlobal Included WithAPI, Flex, Update IntervalNear Real Time |
:id route |
| 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 WithAPI, Flex, Update Interval~Every 6-12 hours (based on SPC) |
:id affects contains search |
| countries |
Geographical data related to countries around the world. Data CoverageGlobal Included WithAPI, Flex, |
:id search |
| droughts/monitor |
Official drought areas per the National Drought Mitigation Center. Data CoverageContinental US Included WithAPI, Flex, Update IntervalWeekly (Thursdays) |
:id affects contains search |
| earthquakes |
Global earthquake data including magnitude, depth, and type. Data CoverageGlobal Included WithAPI, Flex, Update IntervalEvery 2-3 minutes |
:id closest within search affects |
| fires |
Wildfires across the U.S. and Canada with data including type, cause, area, and percent contained. Data CoverageUSA, Canada Included WithAPI, Flex, Update IntervalTen Minutes |
:id closest within search |
| fires/outlook |
SPC’s outlook for weather conditions that will promote the spread of fires. Data CoverageContinental US Included WithAPI, Flex, Update Interval2x Daily |
:id affects contains search within |
| forecasts |
Future weather conditions around the globe. We support daily, hourly, and many other forecast intervals. Data CoverageGlobal Included WithAPI, Flex, Update IntervalUS - hourly, Non-US - 6 hours |
:id route |
| indices |
Global index for a variety of health and outdoor activities. Endpoint can provide current and forecast indices. Data CoverageGlobal Included WithAPI, Flex, Update IntervalReal Time |
:id route |
| lightning |
Global lightning data based on location queries. Endpoint provides data such as location, amperage, and type of strike. Data CoverageGlobal Included WithLightning Add-On, Update IntervalReal Time |
:id closest route |
| lightning/summary |
A summary of lightning strikes that took place across the globe. Search can be limited by intracloud, cloud-to-ground, or both. Data CoverageGlobal Included WithLightning Add-On, Update IntervalReal Time |
:id closest |
| normals |
The 30-year climate normals collected by NOAA across the United States. Data CoverageContinental US, Alaska, Hawaii Included WithAPI, Flex, |
:id closest within search |
| normals/stations |
Stations associated with collecting the climate data for the /normals endpoint. Data CoverageContinental US, Alaska, Hawaii Included WithAPI, Flex, |
:id closest within search |
| observations |
Current conditions provided by the closest weather station. Data CoverageGlobal Included WithAPI, Flex, Update IntervalAirports - 60 minutes, Other - 1-15 minutes |
:id closest within search route |
| observations/archive |
Historical observations by day are available through 2011. Data CoverageGlobal Included WithAPI, Flex, Update IntervalAirports - 60 minutes, Other - 1-15 minutes |
:id closest within search |
| observations/summary |
Daily summaries based on previously recorded observations. Daily summaries are available through 2011.
Data CoverageGlobal Included WithAPI, Flex, Update IntervalEvery 20 minutes |
:id closest search within |
| phrases/summary |
Phrase related to the current and expected conditions for the next several hours. Data CoverageGlobal (Except Australia) Included WithAPI, Flex, |
:id |
| places |
Geographical information for a given location. Including elevation, population, region, country, continent, etc. Data CoverageGlobal Included WithAPI, Flex, Update IntervalMonthly |
:id closest within search |
| places/airports |
Geographical information about airports around the world. Data CoverageGlobal Included WithAPI, Flex, |
:id closest within search |
| places/postalcodes |
Provides geographical information for US and Canadian postal codes. Data CoverageUSA, Canada Included WithAPI, Flex, |
: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 WithAPI, Flex, Update IntervalHourly |
: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 WithAPI, Flex, |
: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 WithAPI, Flex, Update IntervalEvery 2-3 minutes |
: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 WithAPI, Flex, Update IntervalEvery 2-3 minutes |
:id affects search within |
| stormreports |
Local storm reports transmitted by the National Weather Service in the U.S. Data CoverageContinental US, Alaska, Hawaii Included WithAPI, Flex, Update IntervalEvery 15 minutes |
:id closest within search |
| stormreports/summary |
A summary of storm reports derived from the /stormreports endpoint. Data CoverageContinental US, Alaska, Hawaii Included WithAPI, Flex, |
:id search within |
| sunmoon |
Global sun and moon rise / set data. Data CoverageGlobal Included WithAPI, Flex, |
:id |
| sunmoon/moonphases |
Current phase of the moon. Data CoverageGlobal Included WithAPI, Flex, |
:id search contains |
| threats |
Localized threat summary based on the location provided. Endpoint currently supports U.S. locations. Data CoverageContinental US, Alaska, Hawaii Included WithAPI, Flex, Update IntervalNear Real Time |
:id |
| tides |
Current and forecast tide levels for US coasts. Data CoverageContinental US, Alaska, Hawaii Included WithAPI, Flex, Update IntervalMonthly |
:id closest within search |
| tides/stations |
General information about a specific tides station. Data CoverageContinental US, Alaska, Hawaii Included WithAPI, Flex, |
:id closest within search |
| tropicalcyclones |
Provides information on active tropical cyclones across the globe. Data CoverageGlobal Included WithAPI, Flex, Update IntervalEvery 6 hours, or every 1-3 hours near landfall |
:all closest search within affects |
| tropicalcyclones/archive |
Provides archive information on global tropical cyclones. Data CoverageGlobal Included WithAPI, Flex, |
:id closest search within affects |
| version |
Weather API current version. Included WithAPI, Flex, |
|
| winter/snowdepth |
Estimated snow depth across North America. Data CoverageContinental US, Canada Included WithAPI, Flex, Update IntervalDaily |
:id closest |
Last modified: October 12, 2022