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 |
The Air Quality API endpoint provides current information for locations globally. Observed air quality will be interpolated data or specific station observation data depending on the query action. This endpoint includes the air quality index (AQI), category, dominant pollutant, and information for primary pollutants when available. Data CoverageGlobal Included With API Developer, API Premium |
:id closest within search route |
| airquality/forecasts | Currently in BETA The Air Quality API Forecasts endpoint provides information for locations globally. This endpoint can provide daily and hourly forecast data up to 4 days. Forecast data will be interpolated for the exact location queried. Available information includes the air quality index (AQI), category, dominant pollutant, and information for primary pollutants when available. Data CoverageGlobal Included With API Developer, API Premium |
:id |
| alerts |
The alerts endpoint (formerly known as the advisories endpoint) provides access to all currently active US and Canadian alerts as issued by the National Weather Service (NWS) and Environment Canada (EC). Both the NWS and EC issue a variety of weather warnings, watches, advisories, and statements. Within the USA, alerts are issued by either weather zone or county. Within Canada, alerts are issued by Canadian Location Codes. Data CoverageUSA, Canada Included With API Developer, API Basic, API Premium |
:id within closest search |
| alerts/summary |
The alerts/summary endpoint provides an overall summary of the currently active alerts within the USA and Canada based on search/filter criteria. Example use cases include obtaining the total number of active weather zones or counties with active alerts, the types of active alerts, what states currently have active alerts and more. Coverage area includes the 50 US states, Puerto Rico and Canada. Data CoverageUSA, Canada Included With API Developer, API Premium |
:id search within |
| convective/outlook |
The convective/outlook endpoint provides convective outlook information based on the SPC convective outlooks. Convective outlooks provide information on potential severe weather, including thunderstorms, tornadoes, damaging high winds, and hail. Coverage of this endpoint is for the US only. Data CoverageContinental US Included With API Developer, API Premium |
:id affects contains search |
| countries |
The countries dataset provides the core data for countries, returning the full name, abbreviations, capital, population area, and neighboring countries. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id search |
| droughts/monitor |
The droughts/monitor endpoint provides access to the US drought monitor information from the National Drought Mitigation Center. Coverage of this endpoint is for the US only, and data is updated weekly. Data CoverageContinental US Included With API Developer, API Premium |
:id affects contains search |
| earthquakes |
The earthquake data set provides information on US and international earthquakes, including location, magnitude, depth and more. Data CoverageGlobal Included With API Developer, API Premium |
:id closest within search affects |
| fires |
The fires data set contains data for all of the active wildfires across the U.S., including type of fire, area, cause and percent contained. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| fires/outlook |
The fires/outlook endpoint provides fire weather outlook information based on the SPC fire weather outlooks. Coverage of this endpoint is for the US only. Data CoverageContinental US Included With API Developer, API Premium |
:id affects contains search within |
| forecasts |
The forecasts endpoint/data set provides the core forecast data for US and international locations. Forecast information is available in daily, day/night intervals, as well as, custom intervals such as 3 hour or 1 hour intervals. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest route |
| indices |
Indices for health and outdoor activities as based on common weather observations and forecasts. Data CoverageGlobal Included With API Developer, API Premium |
:id route closest |
| lightning |
The lightning API endpoint provides access to global lightning strike data. The lightning data includes information on the type of strike, location, polarity, and amperage. Options are available for both cloud to ground and intracloud (cloud to cloud) pulse types. The lightning API endpoint is available with the weather API premium subscriptions. This lightning data is available globally and to all clients except for our clients or their business operations in Australia, South Africa, and Taiwan. Please contact our accounts team for more information. Data CoverageGlobal Included With API Developer, API Premium |
:id closest search |
| lightning/summary |
The lighting/summary endpoint expands on the lightning API endpoint and provides an overall summary of recent lightning strikes/pulses across the globe. Example use cases include obtaining the total number of recent lighting strikes or pulses around the world or within a geographic area, number of lightning strikes within a specified radius of a location and more. This endpoint can also provide polygons of areas with lightning activity included in the summary, great for plotting areas of concern on a map. The lightning/summary API endpoint is available with the weather API subscriptions. This lightning data is available globally and to all clients except for our clients or their business operations in Australia, South Africa, and Taiwan. Please contact our accounts team for more information. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest search within |
| normals |
The normals endpoint provides access to the 30 year climate normal’s for US locations. This endpoint allows receiving up to 1 month of information per request. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| normals/stations |
The normals/stations dataset provides access to the complete co-op/station information that normals are available for. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| observations |
The observations data set provides access to current and archived weather observations from a variety of reporting stations. The primary source for observation data comes from METARs located at airports or permanent weather stations. METAR reports are generated once an hour, but if conditions change significantly, then additional special reports may be issued. Other sources, such as personal weather stations (PWS), may update more frequently but are not official stations used by NOAA. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest within search route |
| observations/archive |
The observations/archive endpoint provides access to a full day of observations from our archive based on your subscription level. A day of archived observations is based on Midnight - 11:59:59pm local time of the observation station. Data CoverageGlobal Included With API Developer, API Premium |
:id closest within search |
| observations/summary |
The observations/summary endpoint provides access to daily summaries based on received observations. Data CoverageGlobal Included With API Developer, API Premium |
:id closest search within |
| phrases/summary |
The phrases/summary provides weather summary phrasing based on the current conditions and the forecast over the next few hours for the requested location. The limit parameter can be utilized to control the number of hours the summary phrase covers, the default being 6 hours. Data CoverageGlobal Included With API Developer, AMP Basic, API Premium |
:id |
| places |
The places dataset provides the core data for geographical locations, including cities, reporting stations, airports, points of interest (poi), etc. This is typically the first request that is made for every other weather-related request. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest within search |
| places/airports |
The places/airports endpoint provides place information on airports, heliports, sea bases, and balloonports. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id closest within search |
| places/postalcodes |
The places/postalcodes endpoint provides information on US zip codes and Canadian Postal Codes. US 5 digit zip codes and Canadian 6 character postal codes are supported. Data CoverageUSA, Canada Included With API Developer, API Basic, API Premium |
:id closest within search |
| records |
The records data set provides access to daily US records (RER) as transmitted by the National Weather Service (NWS). Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| rivers |
The rivers endpoint provides access to the latest river and lakes gauge observations. The primary source of this gauge observations is the NOAA Advanced Hydrologic Prediction Service (AHPS). The gauge observations include information on the current water level or flow, flood stages, and low water thresholds. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| rivers/gauges |
The rivers/gauges endpoint provides access to enhanced information for the river and lake gauges utilized within the rivers endpoint. The primary source the gauge information is the NOAA Advanced Hydrologic Prediction Service (AHPS). Gauge information will include location information and when available recent crests, historical crests and flood impacts. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest search within |
| stormcells |
The storm cells dataset provides observed and forecast data for all storm cells across the United States. This is a NEXRAD derived product that attempts to identify and track storm cell movement along with reporting cell intensity and certain severe weather signatures within the cell, like rotation and hail. The forecast track can be used to determine when and where a cell will affect a particular location or area. Data CoverageContinental US, Alaska, Hawaii, Puerto Rico, Guam Included With API Developer, API Premium |
:id closest within search affects |
| stormcells/summary |
The stormcells/summary endpoint provides an overall summary on current storm cells based on search / filter criteria. Example uses include obtaining the number of storms cells, maximum hail currently reported within storm cells, number of storm cells with a high probability of hail within a 50 mile radius. This endpoint can also provide polygons of the storm cell groups included in the summary. Coverage area includes the 50 US states, Puerto Rico and Guam Data CoverageContinental US, Alaska, Hawaii, Puerto Rico, Guam Included With API Developer, API Premium |
:id affects search within |
| stormreports |
The storm reports data set provides access to all local storm reports (LSR) as transmitted by the National Weather Service (NWS). These reports are received from storm spotters, such as amateur radio operators, storm chasers, law enforcement, emergency management, or citizens about severe weather conditions in their area. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| stormreports/summary |
The stormreports/summary endpoint provides an overall summary of received storm reports based on search / filter criteria. Example uses include obtaining the number of storm reports received within a time frame and/or geographical area, maximum rainfall or snowfall reported, the number of tornado storm reports within a 50 mile radius. Coverage area includes the 50 US states. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id search within |
| sunmoon |
The sunmoon endpoint provides sunrise/set, twilight, moon rise/set and moon phase information for requested locations and time frames. This endpoint allows receiving up to 1 month of information per request. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id |
| sunmoon/moonphases |
The moonphases endpoint is an extension of the sunmoon endpoint and provides easy access to the moon phase calendar information. Such as the next full, new and quarter moon phases. This endpoint allows receiving up to 1 month of information per request. Data CoverageGlobal Included With API Developer, API Basic, API Premium |
:id search contains |
| threats |
The threats endpoint provides a localized threat summary for the location provided. Currently the threats are limited to storm based threats. Coverage area includes the 50 US states, Puerto Rico and Guam. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id |
| tides |
The tides endpoint provides access to the predicted tidal information for US locations. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| tides/stations |
The tides/stations dataset provides access to the complete station information that tides are available for. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest within search |
| version |
Provides the current version number of the Aeris API. Included With API Developer, API Basic, API Premium |
|
| winter/snowdepth |
The winter/snowdepth endpoint can provide estimated snow depth information for locations throughout the United States and portions of Canada. The endpoint has a spatial resolution of approximately 1km. Data CoverageContinental US, Canada Included With API Developer, API Premium |
:id closest |