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 API. The following endpoints are currently supported within Aeris.
To query multiple endpoints with a single 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 |
|---|---|---|
| advisories |
The advisories data set provides access to all currently active US advisories as issued by the National Weather Service (NWS). The NWS issues a variety of severe weather warnings, watches, advisories and statements that may be issued for a single forecast zone or county, or for a larger region. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Basic, API Premium |
:id within closest search |
| advisories/summary |
The advisories/summary endpoint provides an overall summary of the currently active advisories within the USA based on search / filter criteria. Example uses include obtaining the total number of active weather zones or counties with active advisories, the types of active advisories, what states currently have active advisories and more. Coverage area includes the 50 US states, Puerto Rico. Data CoverageContinental US, Alaska, Hawaii Included With API Developer, API Premium |
:id closest search within |
| convective/outlook |
The convective/outlook endpoint provides convective outlook information based on the SPC convective outlooks. 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, mangnitude, 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 |
| normals |
The normals endpoints provides access to the 30 year climate normal’s for US locations. 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/recent |
The observations/recent endpoint provides access to recent observations, up to the past 30 days depending on API service level. Since this endpoint provides recent observations, all observations will be returned descending by observation date starting with the most recent. Data CoverageGlobal Included With API Developer, API Premium |
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 |
| 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 CoverageContinental US, 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 |
| 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 closest 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 closest search within |
| sunmoon |
The sunmoon endpoint provides sunrise/set, twilight, moon rise/set and moon phase information for requested locations and time frames. 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. 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 normals endpoints 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. |
|
| 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 |