National Weather Service API

https://www.weather.gov/documentation/
Admin
The National Weather Service API provides developers with programmatic access to critical forecasts,...
Tokens:5,820
Snippets:65
Trust Score:9.9
Update:1 month ago
Show doc for...
Tokens:
Raw
### GET /alerts

Source: https://www.weather.gov/documentation/services-web-api

Retrieves a collection of weather alerts.

```APIDOC
## GET /alerts

### Description
Retrieves a collection of weather alerts.

### Method
GET

### Endpoint
/alerts
```

--------------------------------

### GET /alerts

Source: https://www.weather.gov/documentation/services-web-alerts

Retrieves a history of weather alerts.

```APIDOC
## GET /alerts

### Description
Retrieves a history of weather alerts.

### Method
GET

### Endpoint
https://api.weather.gov/alerts
```

--------------------------------

### Full CAP Message Example

Source: https://www.weather.gov/documentation/tb-alerts-CAP-Supporting-360-Character-and-Spanish-WEA

A complete CAP message structure demonstrating the initial alert metadata and language declaration.

```xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
<alert xmlns:ns2="http://gov.fema.ipaws.services/caprequest" xmlns="urn:oasis:names:tc:emergency:cap:1.2" xmlns:ns4="http://gov.fema.ipaws.services/IPAWS_CAPService/" xmlns:ns3="http://gov.fema.ipaws.services/capresponse">  
<identifier>NWS-IDP-DEV-3889295-3321272</identifier>  
<sender>w-nws.webmaster@noaa.gov</sender>  
<sent>2020-01-23T08:23:00-06:00</sent>  
<status>Actual</status>  
<msgType>Alert</msgType>  
<scope>Public</scope>  
<code>IPAWSv1.0</code>  
<note></note>  
<info>  
<language>en-US</language>
```

--------------------------------

### English WEA Info Block Configuration

Source: https://www.weather.gov/documentation/tb-alerts-CAP-Supporting-360-Character-and-Spanish-WEA

Example of an <info> block configured for English WEA, including the 360-character CMAMlongtext and 90-character CMAMtext parameters.

```xml
<info>  
<language>en-US</language>  
...
<parameter>  
<valueName>WEAHandling</valueName>  
<value>Imminent Threat</value>  
</parameter>
<parameter>  
<valueName>CMAMlongtext</valueName>  
<value>**National Weather Service: TORNADO WARNING in this area until 12:00 AM EDT. Take shelter now in a basement or an interior room on the lowest floor of a sturdy building. If you are outdoors, in a mobile home, or in a vehicle, move to the closest substantial shelter and protect yourself from flying debris. Check media. <**/value>  
</parameter>
<parameter>  
<valueName>CMAMtext</valueName>  
<value>**NWS: TORNADO WARNING in this area til 12:00 AM EDT. Take shelter now. Check media.** </value>  
</parameter>
...  
<info>
```

--------------------------------

### GET /gridpoints/{wfo}/{x},{y}

Source: https://www.weather.gov/documentation/services-web-api

Retrieves gridpoint data for a specific weather forecast office and coordinate pair.

```APIDOC
## GET /gridpoints/{wfo}/{x},{y}

### Description
Retrieves gridpoint data for a specific weather forecast office and coordinate pair.

### Method
GET

### Endpoint
/gridpoints/{wfo}/{x},{y}

### Parameters
#### Path Parameters
- **wfo** (string) - Required - Weather Forecast Office identifier
- **x** (number) - Required - Grid X coordinate
- **y** (number) - Required - Grid Y coordinate
```

--------------------------------

### GET /stations/{stationId}/observations

Source: https://www.weather.gov/documentation/services-web-api

Retrieves weather observations for a specific station.

```APIDOC
## GET /stations/{stationId}/observations

### Description
Retrieves weather observations for a specific station.

### Method
GET

### Endpoint
/stations/{stationId}/observations

### Parameters
#### Path Parameters
- **stationId** (string) - Required - The station identifier
```

--------------------------------

### GET /alerts/active

Source: https://www.weather.gov/documentation/services-web-alerts

Retrieves active weather alerts with optional filtering parameters.

```APIDOC
## GET /alerts/active

### Description
Retrieves active weather alerts. Supports filtering by area, point, region, or zone.

### Method
GET

### Endpoint
https://api.weather.gov/alerts/active

### Parameters
#### Query Parameters
- **area** (string) - Optional - Filter by state or marine area code (e.g., MO, LM).
- **point** (string) - Optional - Filter by latitude and longitude (e.g., 39,-90).
- **region** (string) - Optional - Filter by region code (e.g., AT).
- **zone** (string) - Optional - Filter by zone or county code (e.g., ALZ034, ALC007).
```

--------------------------------

### Spanish WEA Info Block Configuration

Source: https://www.weather.gov/documentation/tb-alerts-CAP-Supporting-360-Character-and-Spanish-WEA

Example of an <info> block configured for Spanish WEA, using the es-US language code and Spanish-translated parameter values.

```xml
<info>  
<language>es-US</language>  
...
<parameter>  
<valueName>WEAHandling</valueName>  
<value>Imminent Threat</value>  
</parameter>
<parameter>  
<valueName>CMAMlongtext</valueName>  
<value>**Servicio Nacional de Meteorologia: AVISO DE TORNADO en efecto hasta las 12:00 AM EDT. Busque refugio ahora en un sotano o en el interior de un cuarto en el nivel mas bajo de un edificio seguro. Si esta al aire libre, en una casa movil, o en un vehiculo, debe ir al edificio seguro mas cercano y protegerse de proyectiles. Consulte los medios informativos.** </value>  
</parameter>
<parameter>  
<valueName>CMAMtext</valueName>  
<value>**SNM: AVISO DE TORNADO hasta las 10:33 AM CDT. Refugiese ahora. Consulte medios informativos.** </value>  
</parameter>
...  
<info>
```

--------------------------------

### GET /points/{latitude},{longitude}

Source: https://www.weather.gov/documentation/services-web-api

Retrieves metadata for a specific latitude and longitude point.

```APIDOC
## GET /points/{latitude},{longitude}

### Description
Retrieves metadata for a specific latitude and longitude point.

### Method
GET

### Endpoint
/points/{latitude},{longitude}

### Parameters
#### Path Parameters
- **latitude** (number) - Required - Latitude coordinate
- **longitude** (number) - Required - Longitude coordinate
```

--------------------------------

### GET /gridpoints/{office}/{gridX},{gridY}/forecast

Source: https://www.weather.gov/documentation/services-web-api

Retrieves the 12h forecast periods for a specific grid location.

```APIDOC
## GET /gridpoints/{office}/{gridX},{gridY}/forecast

### Description
Retrieves the 12h forecast periods for a specific grid location at a resolution of approximately 2.5km x 2.5km.

### Method
GET

### Endpoint
https://api.weather.gov/gridpoints/{office}/{gridX},{gridY}/forecast

### Parameters
#### Path Parameters
- **office** (string) - Required - The NWS Weather Forecast Office identifier.
- **gridX** (integer) - Required - The grid X coordinate.
- **gridY** (integer) - Required - The grid Y coordinate.
```

--------------------------------

### GET /points/{latitude},{longitude}

Source: https://www.weather.gov/documentation/services-web-api

Retrieves grid forecast endpoints and location metadata for a specific coordinate.

```APIDOC
## GET /points/{latitude},{longitude}

### Description
Retrieves the grid forecast endpoints (forecast, forecastHourly, forecastGridData) and metadata for a specific point location.

### Method
GET

### Endpoint
https://api.weather.gov/points/{latitude},{longitude}

### Parameters
#### Path Parameters
- **latitude** (float) - Required - The latitude coordinate.
- **longitude** (float) - Required - The longitude coordinate.
```

--------------------------------

### Set Accept Header for Format

Source: https://www.weather.gov/documentation/services-web-api

Specifies the desired response format using the Accept header.

```http
Accept: application/cap+xml
```

--------------------------------

### Set User-Agent Header

Source: https://www.weather.gov/documentation/services-web-api

Required header to identify your application. Including contact information is recommended for security notifications.

```http
User-Agent: (myweatherapp.com, contact@myweatherapp.com)
```

--------------------------------

### Retrieve Gridpoint from Coordinates

Source: https://www.weather.gov/documentation/services-web-api

Endpoint for converting latitude and longitude coordinates into a grid forecast endpoint.

```text
https://api.weather.gov/points/{latitude},{longitude}
```

--------------------------------

### Set Feature-Flags Header

Source: https://www.weather.gov/documentation/services-web-api

Used to enable specific API features as communicated via Service Change Notices.

```http
Feature-Flags: forecast_temperature_qv
```

--------------------------------

### CAP Alert XML Structure with Spanish WEA

Source: https://www.weather.gov/documentation/tb-alerts-CAP-Supporting-360-Character-and-Spanish-WEA

This XML snippet demonstrates a Tornado Warning alert containing specific parameters for WEA handling and Spanish language text fields.

```xml
<headline>Tornado Warning issued January 23 at 2:23PM CST until January 23 at 8:28AM CST by NWS Shreveport LA</headline>  
<description>The National Weather Service in Shreveport has issued a
* Tornado Warning for...  
Southern Caldwell Parish in north central Louisiana...  
Northeastern La Salle Parish in north central Louisiana...
* Until 228 PM
* At 223 PM CDT, a large and extremely dangerous tornado was located  
near Midway, or 22 miles northeast of Pineville, moving northeast  
at 40 mph.
This is a PARTICULARLY DANGEROUS SITUATION. TAKE COVER NOW!
HAZARD...Damaging tornado.
SOURCE...Radar indicated rotation.
IMPACT...You are in a life-threatening situation. Flying debris  
may be deadly to those caught without shelter. Mobile  
homes will be destroyed. Considerable damage to homes,  
businesses, and vehicles is likely and complete  
destruction is possible.
* The tornado will be near...  
Jena around 410 PM CDT.  
Midway around 415 PM CDT.
Other locations impacted by this tornadic thunderstorm include Nebo.</description>  
<instruction>To repeat, a large, extremely dangerous and potentially deadly  
tornado is developing. To protect your life, TAKE COVER NOW! Move to  
a basement or an interior room on the lowest floor of a sturdy  
building. Avoid windows. If you are outdoors, in a mobile home, or in  
a vehicle, move to the closest substantial shelter and protect  
yourself from flying debris.</instruction>  
<web>http://www.weather.gov</web>  
<parameter>  
<valueName>eventMotionDescription</valueName>  
<value>2020-01-23T15:01:00.000-06:00...storm...209DEG...35KT...31.6,-92.19 </value>  
</parameter>  
<parameter>  
<valueName>hailSize</valueName>  
<value>1.75</value>  
</parameter>  
<parameter>  
<valueName>tornadoDetection</valueName>  
<value>RADAR INDICATED</value>  
</parameter>  
<parameter>  
<valueName>tornadoDamageThreat</valueName>  
<value>CONSIDERABLE</value>  
</parameter>  
<parameter>  
<valueName>VTEC</valueName>  
<value>/O.NEW.KSHV.TO.W.0048.200123T1423Z-200123T1428Z/</value>  
</parameter>  
<parameter>  
<valueName>EAS-ORG</valueName>  
<value>WXR</value>  
</parameter>  
<parameter>  
<valueName>PIL</valueName>  
<value>SHVTORSHV</value>  
</parameter>  
<parameter>  
<valueName>BLOCKCHANNEL</valueName>  
<value>EAS</value>  
</parameter>  
<parameter>  
<valueName>BLOCKCHANNEL</valueName>  
<value>NWEM</value>  
</parameter>  
<parameter>  
<valueName>eventEndingTime</valueName>  
<value>2020-01-23T08:28:00-06:00</value>  
</parameter>  
<parameter>  
<valueName>CMAMlongtext</valueName>  
<value>Servicio Nacional de Meteorologia: AVISO DE TORNADO en efecto hasta las 8:28 AM CST. Busque refugio ahora en un sotano o en el interior de un cuarto en el nivel mas bajo de un edificio seguro. Si esta al aire libre, en una casa movil, o en un vehiculo, debe ir al edificio seguro mas cercano y protegerse de proyectiles. Consulte los medios informativos.</value>  
</parameter>  
<parameter>  
<valueName>CMAMtext</valueName>  
<value>SNM: AVISO DE TORNADO hasta las 8:28 AM CST. Refugiese ahora. Consulte medios informativos.</value>  
</parameter>  
<parameter>  
<valueName>WEAHandling</valueName>  
<value>Imminent Threat</value>  
</parameter>  
<area>  
<areaDesc>La Salle, LA; Caldwell, LA</areaDesc>  
<polygon>31.72,-92.01 31.66,-92.04 31.55,-92.15 31.6,-92.28 31.93,-92.12 31.92,-92.01 31.72,-92.01</polygon>  
<geocode>  
<valueName>UGC</valueName>  
<value>LAC059</value>  
</geocode>  
<geocode>  
<valueName>UGC</valueName>  
<value>LAC021</value>  
</geocode>  
<geocode>  
<valueName>SAME</valueName>  
<value>022059</value>  
</geocode>  
<geocode>  
<valueName>SAME</valueName>  
<value>022021</value>  
</geocode>  
</area>  
</info>  
</alert>
```

--------------------------------

### Retrieve Grid Forecast

Source: https://www.weather.gov/documentation/services-web-api

Endpoint structure for accessing 12-hour forecast periods at a specific NWS grid location.

```text
https://api.weather.gov/gridpoints/{office}/{gridX},{gridY}/forecast
```

--------------------------------

### CAP Alert Update Header Structure

Source: https://www.weather.gov/documentation/tb-alerts-CAP-Supporting-360-Character-and-Spanish-WEA

This snippet shows the header portion of a CAP alert update, including references to previous messages and status indicators.

```xml
<?xml version="1.0" encoding="UTF-8" standalone="yes"?>  
<alert xmlns:ns2="http://gov.fema.ipaws.services/caprequest" xmlns="urn:oasis:names:tc:emergency:cap:1.2" xmlns:ns4="http://gov.fema.ipaws.services/IPAWS_CAPService/" xmlns:ns3="http://gov.fema.ipaws.services/capresponse">  
<identifier>NWS-IDP-DEV-3889297-3321274</identifier>  
<sender>w-nws.webmaster@noaa.gov</sender>  
<sent>2020-01-23T08:24:00-06:00</sent>  
<status>Actual</status>  
<msgType>Update</msgType>  
<scope>Public</scope>  
<code>IPAWSv1.0</code>  
<note></note>  
<references>w-nws.webmaster@noaa.gov,NWS-IDP-DEV-3889295-3321272,2020-01-23T08:23:00-06:00</references>  
<info>  
<language>en-US</language>  
<category>Met</category>  
<event>Tornado Warning</event>  
<responseType>Shelter</responseType>  
<urgency>Immediate</urgency>  
<severity>Extreme</severity>  
<certainty>Observed</certainty>  
<eventCode>  
<valueName>SAME</valueName>  
<value>TOR</value>  
</eventCode>  
<eventCode>  
<valueName>NationalWeatherService</valueName>  
<value>TOW</value>  
</eventCode>  
<effective>2020-01-23T08:24:00-06:00</effective>
```

--------------------------------

### Retrieve Active Alerts by State

Source: https://www.weather.gov/documentation/services-web-api

Endpoint for filtering active weather alerts based on a specific state area code.

```text
https://api.weather.gov/alerts/active?area={state}
```
Tokens:
Raw