Skip to main content
All providers

National Weather Service

WeatherUS

api.weather.gov

US forecasts, observations and active alerts from the National Weather Service.

Capabilities (21)

GET /v1/data/weathergov/alerts1 credit

Returns every NWS alert currently in force nationwide as a GeoJSON FeatureCollection - warnings, watches, advisories and statements - each with event type, severity, urgency, certainty, affected areas, effective and expiry times and the full headline and instruction text.

area?point?region?region_type?zone?status?message_type?event?code?urgency?severity?certainty?
GET /v1/data/weathergov/alerts-archive1 credit

Returns alerts from the NWS archive rather than only those in force, supporting a time window plus the same area, zone, event and severity filters as the active feed.

start?end?area?point?region?region_type?zone?status?message_type?event?code?urgency?severity?certainty?limit?cursor?
GET /v1/data/weathergov/alerts-area1 credit

Returns the alerts currently in force for one state, territory or marine area, in the same shape as the nationwide active-alerts feed. An empty features array simply means that area has nothing in force.

area
GET /v1/data/weathergov/alerts-count1 credit

Returns a summary of how many alerts are currently active in total and broken down by land area, marine region and individual zone.

No parameters
GET /v1/data/weathergov/alert-types1 credit

Returns the complete list of NWS alert event names, the controlled vocabulary used by the 'event' filter on the alerts capabilities.

No parameters
GET /v1/data/weathergov/gridpoint1 credit

Returns the full set of raw forecast variables the NWS office published for one grid cell - temperature, dewpoint, wind, sky cover, probability of precipitation, snowfall, hazards and dozens more - each as a time-series of ISO-8601 interval/value pairs.

officegridXgridY
GET /v1/data/weathergov/gridpoint-forecast1 credit

Returns the NWS textual forecast for one 2.5 km grid cell as roughly 14 day/night periods, each with a name, temperature, wind, a short forecast phrase and a detailed narrative.

officegridXgridYunits?feature_flags?
GET /v1/data/weathergov/gridpoint-forecast-hourly1 credit

Returns the same NWS forecast for a grid cell broken into one-hour periods for about seven days, each with temperature, dewpoint, humidity, wind, probability of precipitation and a short forecast phrase.

officegridXgridYunits?feature_flags?
GET /v1/data/weathergov/gridpoint-stations1 credit

Returns the observation stations the NWS associates with a forecast grid cell, nearest first, each with its id, name, elevation and coordinates.

officegridXgridYlimit?cursor?
GET /v1/data/weathergov/office1 credit

Returns a NWS Weather Forecast Office record: its name, postal address, phone, email, parent region, the counties, forecast zones and fire zones it covers, and links to its products.

officeId
GET /v1/data/weathergov/point1 credit

Returns the NWS metadata for a coordinate: the forecast office, the forecast grid X/Y, the forecast and county zones, the time zone, the radar station, and ready-made URLs for that point's forecast, hourly forecast and nearby observation stations.

point
GET /v1/data/weathergov/products-by-office1 credit

Returns the recent issuances of one text product type from one issuing office, each with its product id, WMO collective id, issuance time and product name.

typeIdlocationId
GET /v1/data/weathergov/product-types1 credit

Returns every NWS text product type code with its human name - AFD for Area Forecast Discussion, HWO for Hazardous Weather Outlook, and several hundred more.

No parameters
GET /v1/data/weathergov/radar-station1 credit

Returns one radar station's full record: location, elevation, operational mode, generating and reporting timestamps, latency figures and current performance telemetry.

radarStationIdreportingHost?host?
GET /v1/data/weathergov/radar-stations1 credit

Returns all NWS radar stations as a GeoJSON FeatureCollection with id, name, type, coordinates, elevation, time zone and current operational status.

stationType?host?reportingHost?
GET /v1/data/weathergov/station1 credit

Returns one observation station's record: name, elevation, time zone, coordinates, the forecast office that owns it and links to its observation history.

stationId
GET /v1/data/weathergov/station-observation-latest1 credit

Returns the single most recent observation from a station: temperature, dewpoint, wind, barometric pressure, visibility, humidity, heat index, wind chill, cloud layers and the decoded textual description, each with its unit of measure and quality-control flag.

stationIdrequire_qc?
GET /v1/data/weathergov/station-observations1 credit

Returns a time-ordered FeatureCollection of past observations from one station, each with the same decoded fields as the latest observation.

stationIdstart?end?limit?
GET /v1/data/weathergov/stations1 credit

Returns NWS observation stations as a GeoJSON FeatureCollection with id, name, elevation, time zone and coordinates for each, filterable by state or station id.

id?state?limit?cursor?
GET /v1/data/weathergov/zone-forecast1 credit

Returns the NWS zone forecast product for one forecast zone as a list of day/night periods with narrative text and the issue and expiry times.

zoneId
GET /v1/data/weathergov/zones1 credit

Returns NWS zones as a GeoJSON FeatureCollection with each zone's id, type, name, state, owning office and boundary geometry.

type?area?region?id?point?effective?include_geometry?

Licence

A work of the United States Government, not subject to domestic copyright under 17 U.S.C. 105, published by the agency as open data.

https://www.weather.gov/disclaimer

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: NOAA/National Weather Service

Cache: up to 600s