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

Alerts & Warnings

Watches, warnings and advisories. This is the life-safety feed — for real decisions use official channels, but this is where the data lives.

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

The same alert data, but searchable through time rather than only right now. You can ask for alerts issued during a past window, which makes it the endpoint for “what was warned, and when”.

Researchers studying warning performance; journalists reconstructing an event timeline.

17 parameters
Name In Required Notes
active query no List only active alerts (use /alerts/active endpoints instead) boolean
start query no Start time string (date-time)
end query no End time string (date-time)
status query no Status (actual, exercise, system, test, draft) array
message_type query no Message type (alert, update, cancel) array
event query no Event name array
code query no Event code array
area query no State/territory code or marine area code This parameter is incompatible with the following parameters: point, region, region_type, zone array
point query no Point (latitude,longitude) This parameter is incompatible with the following parameters: area, region, region_type, zone
region query no Marine region code This parameter is incompatible with the following parameters: area, point, region_type, zone array
region_type query no Region type (land or marine) This parameter is incompatible with the following parameters: area, point, region, zone one of: land, marine
zone query no Zone ID (forecast or county) This parameter is incompatible with the following parameters: area, point, region, region_type array
urgency query no Urgency (immediate, expected, future, past, unknown) array
severity query no Severity (extreme, severe, moderate, minor, unknown) array
certainty query no Certainty (observed, likely, possible, unlikely, unknown) array
limit query no Limit integer
cursor query no Pagination cursor string
Worked example

Worked example

https://api.weather.gov/alerts?area=KS&limit=20
Open on api.weather.gov

cURL

curl "https://api.weather.gov/alerts?area=KS&limit=20" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/alerts/{id}

One specific watch, warning or advisory, fetched by its identifier — the full text, affected area and timing for a single alert.

Anyone following a link from another alert response.

GET https://api.weather.gov/alerts/active

Every watch, warning and advisory currently in effect anywhere in the United States, as structured data with the affected area attached. You can filter by point, area, zone, severity, urgency and event type.

Emergency managers, newsrooms, and anyone building a severe weather map or notification service.

12 parameters
Name In Required Notes
status query no Status (actual, exercise, system, test, draft) array
message_type query no Message type (alert, update, cancel) array
event query no Event name array
code query no Event code array
area query no State/territory code or marine area code This parameter is incompatible with the following parameters: point, region, region_type, zone array
point query no Point (latitude,longitude) This parameter is incompatible with the following parameters: area, region, region_type, zone
region query no Marine region code This parameter is incompatible with the following parameters: area, point, region_type, zone array
region_type query no Region type (land or marine) This parameter is incompatible with the following parameters: area, point, region, zone one of: land, marine
zone query no Zone ID (forecast or county) This parameter is incompatible with the following parameters: area, point, region, region_type array
urgency query no Urgency (immediate, expected, future, past, unknown) array
severity query no Severity (extreme, severe, moderate, minor, unknown) array
certainty query no Certainty (observed, likely, possible, unlikely, unknown) array
Worked example

Worked example

https://api.weather.gov/alerts/active?area=KS

All alerts currently active in Kansas. Swap the state code for anywhere else.

Open on api.weather.gov

cURL

curl "https://api.weather.gov/alerts/active?area=KS" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/alerts/active/area/{area}

Active alerts for a whole state or marine area, by two-letter code.

Statewide emergency management and state-level news coverage.

Worked example

Worked example

https://api.weather.gov/alerts/active/area/KS
Open on api.weather.gov

cURL

curl "https://api.weather.gov/alerts/active/area/KS" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/alerts/active/count

Just the numbers: how many alerts are active right now, broken down by region, area and zone. A cheap way to check whether anything is happening without pulling every alert.

Dashboards and monitoring systems that poll frequently.

Worked example

Worked example

https://api.weather.gov/alerts/active/count
Open on api.weather.gov

cURL

curl "https://api.weather.gov/alerts/active/count" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/alerts/active/region/{region}

Active alerts for one of the large marine regions — Atlantic north and south, Pacific north and south, Gulf of Mexico.

Marine forecasting and shipping.

Worked example

Worked example

https://api.weather.gov/alerts/active/region/GL
Open on api.weather.gov

cURL

curl "https://api.weather.gov/alerts/active/region/GL" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/alerts/active/zone/{zoneId}

Active alerts for one specific forecast zone or county.

Sites scoped to a single community.

Worked example

Worked example

https://api.weather.gov/alerts/active/zone/KSZ009
Open on api.weather.gov

cURL

curl "https://api.weather.gov/alerts/active/zone/KSZ009" \
  -H "User-Agent: (myweatherapp.example.com, me@example.com)"
GET https://api.weather.gov/alerts/types

The full list of alert event names NWS can issue — everything from “Tornado Warning” to “Ashfall Advisory”. Useful for building a filter UI without hard-coding a list that goes stale.

Developers building alert filters or legends.

Worked example

Worked example

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

cURL

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