API Endpoints

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
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 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.

For access to dates beyond yesterday, an Archive Add-On is required.

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.

For access to dates beyond yesterday, an Archive Add-On is required.

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
precip/summary

Currently in BETA

An estimated precipitation total for locations in the U.S. for the last 72 hours. Endpoint allows various intervals such as hourly and daily.

Data CoverageContinental US

Included With AMP Developer,  AMP Premium

:id
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

Provides information on active tropical cyclones across the globe.

Data CoverageGlobal

Included With API Developer,  API Premium

:all
closest
search
within
affects
tropicalcyclones/archive

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