To access Lightning, Lightning Summary, Lightning Threats, lightning mapping features, or historical lightning data, select our Lightning Add-On when building your Flex subscription or contact us to add it to your existing plan.
Lightning Flash data and mapping layers can be accessed from your Flex subscription.
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 WithFlex, API, Update IntervalHourly |
:id closest within search route |
airquality/forecasts |
Future Air Quality Index around the globe including each individual pollutant. Data CoverageGlobal Included WithFlex, API, Update IntervalHourly |
:id |
alerts |
Mild to severe weather events issued to the public from the Canadian and US government. Data CoverageUSA, Canada, Europe Included WithFlex, API, Update IntervalReal Time |
:id route |
alerts/summary |
Summary of active weather events across Canada, the US, and Europe. This endpoint is derived from the /alerts endpoint. Data CoverageUSA, Canada, Europe Included WithAPI, Flex, Update IntervalNear Real Time |
: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 WithFlex, API, 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 WithFlex, API, 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, Update IntervalN/A |
: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 |
energy/farm |
The energy farm endpoint provides energy output data for energy producing sites. Data CoverageContinental US, Canada Included WithAPI Developer, Update IntervalHourly |
:id |
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 IntervalHourly |
: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/flash |
Global lightning flash data based on location queries. Data CoverageGlobal Included WithFlex, Update IntervalNear Real 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 |
lightning/threats |
Lightning nowcasts providing global potential thunderstorm activity. Data CoverageGlobal Included WithLightning Add-On, Update IntervalEvery 2 minutes |
:id contains closest affects route |
maritime |
The maritime API provides essential global marine weather data for navigation, offshore operations, coastal monitoring, and recreational activities, with flexible hourly or other intervals. Data CoverageGlobal Included WithFlex, API, Update IntervalEvery 6 Hours |
:id route |
normals |
The 30-year climate normals collected by NOAA across the United States. Data CoverageContinental US, Alaska, Hawaii Included WithAPI, Flex, Update IntervalN/A |
: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, Update IntervalN/A |
:id closest within search |
observations |
Current conditions provided by the closest weather station. Data CoverageGlobal Included WithAPI, Flex, Update Interval1 - 60+ minutes; varies by individual station |
:id closest within search route |
observations/archive |
Historical observations by day are available through 2011. Data CoverageGlobal Included WithFlex, API, Update Interval1 - 60+ minutes; varies by individual station |
: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, Update IntervalNear Real Time |
: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, Update IntervalNear Real Time |
:id closest within search |
places/postalcodes |
Provides geographical information for US and Canadian postal codes. Data CoverageUSA, Canada Included WithAPI, Flex, Update IntervalN/A |
: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, Update IntervalN/A |
:id closest search within |
roadweather |
AerisWeather’s roadweather endpoint offers real-time, accurate road condition insights powered by Vaisala Xweather forecasts, enhancing user safety and decision-making for optimal driving experiences. Data CoverageNorth America, Europe, Japan Included WithFlex, API, Update IntervalEvery 15 Minutes |
:id route |
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, Update IntervalEvery 15 minutes |
:id search within |
sunmoon |
Global sun and moon rise / set data. Data CoverageGlobal Included WithAPI, Flex, Update IntervalN/A |
:id |
sunmoon/moonphases |
Current phase of the moon. Data CoverageGlobal Included WithAPI, Flex, Update IntervalN/A |
: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, Puerto Rico, Guam Included WithAPI, Flex, Update IntervalN/A |
:id closest within search |
tropicalcyclones |
Provides information on active tropical cyclones across the globe. Data CoverageGlobal Included WithAPI, Flex, Update IntervalEvery 6 hours; NHC storms up to 1-3 hours near landfall |
:all closest search within affects |
tropicalcyclones/archive |
Provides archive information on global tropical cyclones. Data CoverageGlobal Included WithAPI, Flex, Update IntervalEvery 6 hours; NHC storms up to 1-3 hours near landfall |
:id closest search within affects |
version |
Weather API current version. Included WithAPI, Flex, |
Last modified: May 15, 2023