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 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 |
| advisories/summary |
The advisories/summary endpoint provides an overall summary of the currently active advisories 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 advisories, the types of active advisories, what states currently have active advisories and more. Coverage area includes the 50 US states, Puerto Rico and Canada. Data CoverageUSA, Canada 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 |
| lightning |
The lightning 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. Data is available globally, with the exception of Australia. The lightning endpoint is available via the Lighting API add-on to the Aeris Weather API. Contact us for free developer trial access. Data CoverageGlobal (Except Australia) Included With API - Lightning Developer, API - Lightning Basic, API - Lightning Premium |
:id closest search |
| 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/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 |