MAVERICK WX

Source
api.weather.gov

Categories

All endpoints69 Start Here3Forecasts5Alerts & Warnings8Observations & Stations7Radar8Aviation9Text Products9Zones & Geography4Offices & Outreach8NOAA Weather Radio3Icons, Imagery & Extras5

API Explorer

Every endpoint on api.weather.gov, grouped and explained for people who don’t already speak NWS — what it returns, who wants it, and a worked example you can run.

Built from the live OpenAPI spec (version 3.11.0) on 2026-08-22. New here? Start with how it thinks.

69 endpoints shown

Text Products

The raw text bulletins NWS has issued for decades — forecast discussions, administrative messages, statements. Hundreds of product types, all searchable.

GET https://api.weather.gov/products

Search recent text products across types, offices and time.

Researchers and anyone monitoring a particular kind of bulletin.

7 parameters
Name In Required Notes
location query no Location id array
start query no Start time string (date-time)
end query no End time string (date-time)
office query no Issuing office array
wmoid query no WMO id code array
type query no Product code array
limit query no Limit integer
Worked example

Worked example

https://api.weather.gov/products?type=AFD&limit=5
Open on api.weather.gov

cURL

curl "https://api.weather.gov/products?type=AFD&limit=5" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/products/{productId}

One text product in full, including its raw text exactly as it was transmitted. The text is the real payload — fixed-width, uppercase in places, and unchanged in style for decades.

Anyone who wants to read the actual bulletin rather than a summary of it.

GET https://api.weather.gov/products/locations

Every office and centre that issues text products, by identifier.

Developers mapping office codes to names.

Worked example

Worked example

https://api.weather.gov/products/locations
Open on api.weather.gov

cURL

curl "https://api.weather.gov/products/locations" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/products/locations/{locationId}/types

Every product type a given office publishes. A good way to discover what your local forecast office actually puts out beyond the forecast.

Anyone exploring one office’s output.

Worked example

Worked example

https://api.weather.gov/products/locations/TOP/types
Open on api.weather.gov

cURL

curl "https://api.weather.gov/products/locations/TOP/types" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/products/types

The catalogue of every text product type NWS issues — over 300 three-letter codes, from AFD (the forecaster’s reasoning) to ADM (administrative messages from the Senior Duty Meteorologist). This is the index to decades of institutional writing.

Anyone exploring what NWS actually publishes beyond the forecast.

Worked example

Worked example

https://api.weather.gov/products/types
Open on api.weather.gov

cURL

curl "https://api.weather.gov/products/types" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/products/types/{typeId}

Recent products of one type, from every office that issues it.

Anyone tracking one product type nationally.

Worked example

Worked example

https://api.weather.gov/products/types/AFD
Open on api.weather.gov

cURL

curl "https://api.weather.gov/products/types/AFD" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/products/types/{typeId}/locations

Which offices and national centres issue a given product type — the list of places to look for that kind of bulletin.

Developers building a product browser.

Worked example

Worked example

https://api.weather.gov/products/types/AFD/locations
Open on api.weather.gov

cURL

curl "https://api.weather.gov/products/types/AFD/locations" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/products/types/{typeId}/locations/{locationId}

Recent products of one type from one office — for example every Area Forecast Discussion from Topeka, or every administrative message from the Senior Duty Meteorologist.

This is the endpoint behind this site’s SDM translator. Also anyone following their local office’s forecast discussion.

Worked example

Worked example

https://api.weather.gov/products/types/ADM/locations/SDM

The Senior Duty Meteorologist’s administrative messages — the feed this site translates.

Open on api.weather.gov

cURL

curl "https://api.weather.gov/products/types/ADM/locations/SDM" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/products/types/{typeId}/locations/{locationId}/latest

Just the newest product of a given type from a given office, without listing the rest.

Anyone polling for “has a new one come out yet”.

Worked example

Worked example

https://api.weather.gov/products/types/AFD/locations/TOP/latest
Open on api.weather.gov

cURL

curl "https://api.weather.gov/products/types/AFD/locations/TOP/latest" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"