# NWS API: List weather alerts > Lists active US weather watches, warnings and advisories for a city, address, ZIP code or state, most severe first, then newest. Unofficial. Not affiliated with or endorsed by NWS. - Page: https://fous.com/methods/weather.gov/list-weather-alerts - Method: `weather.gov/list_weather_alerts`, version 1 - Website: weather.gov - Returns: event, severity, urgency, headline, areas affected, effective and expiry times, description, instructions, issuing office, page URL, alert ID - Effect: read (it gets data and changes nothing) - Sign-in: none needed - Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free ## Inputs | Field | Type | Required | In the run below | Description | |---|---|---|---|---| | `location` | string | yes | `"Texas"` | US city, street address, ZIP code, state name or state code, such as Tulsa, OK; 74103; or Texas. | | `min_severity` | string | no | | Minimum alert severity, such as severe. Any includes alerts with unknown severity. One of "any", "minor", "moderate", "severe", "extreme". Default "any". | ## Output From a run on Oct 23, 2026. Its input: ```json { "location": "Texas" } ``` Its output: ```json { "alerts": [] } ``` ## Run it From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output: ```bash curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"weather.gov/list_weather_alerts","input":{"location":"Texas"}}' ``` From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`. ## Ask your agent - Are there any active tornado or flash flood warnings for Tulsa, OK right now? - Show me only severe or extreme weather alerts for ZIP code 30301 - What watches, warnings or advisories are in effect for the state of Texas? - I'm heading to 1600 Pennsylvania Ave, Washington DC — any current weather alerts I should know about? - List moderate-or-worse weather advisories for Minnesota, most severe first, with their expiry times ## Input schema ```json { "type": "object", "required": [ "location" ], "properties": { "location": { "type": "string", "description": "US city, street address, ZIP code, state name or state code, such as Tulsa, OK; 74103; or Texas." }, "min_severity": { "enum": [ "any", "minor", "moderate", "severe", "extreme" ], "type": "string", "default": "any", "description": "Minimum alert severity, such as severe. Any includes alerts with unknown severity." } } } ``` ## Output schema ```json { "type": "object", "required": [ "alerts" ], "properties": { "alerts": { "type": "array", "items": { "type": "object", "required": [ "event", "severity", "urgency", "headline", "areas_affected", "effective_time", "expiry_time", "description", "instructions", "issuing_office", "page_url", "alert_id" ], "properties": { "event": { "type": [ "string", "null" ] }, "urgency": { "type": [ "string", "null" ] }, "alert_id": { "type": [ "string", "null" ], "x-fous-developer": true }, "headline": { "type": [ "string", "null" ] }, "page_url": { "type": [ "string", "null" ] }, "severity": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "expiry_time": { "type": [ "string", "null" ], "description": "Alert expiration time in ISO 8601 with offset." }, "instructions": { "type": [ "string", "null" ] }, "areas_affected": { "type": [ "string", "null" ] }, "effective_time": { "type": [ "string", "null" ], "description": "Alert effective time in ISO 8601 with offset." }, "issuing_office": { "type": [ "string", "null" ] } }, "additionalProperties": false }, "description": "Active watches, warnings, and advisories, ordered most severe first, then newest." } }, "additionalProperties": false } ``` ## See more - [NWS API: Get current conditions](https://fous.com/methods/weather.gov/get-current-conditions.md): Gets the latest observed weather from a nearby National Weather Service station for a US city, address, or ZIP code. Measurements the station does not report are null. - [NWS API: Get National Weather Service forecast](https://fous.com/methods/weather.gov/get-forecast.md): Looks up the National Weather Service seven-day day and night forecast for a U.S. city, address, or ZIP code. Forecast availability depends on NWS land-grid coverage. - [NWS API: Get hourly forecast](https://fous.com/methods/weather.gov/get-hourly-forecast.md): Looks up a US city, street address or ZIP code and returns up to 156 hourly National Weather Service forecasts for it. - [The Weather Channel API: List weather alerts](https://fous.com/methods/weather.com/list-weather-alerts.md): Lists active severe weather alerts for a city, address, ZIP or postcode on The Weather Channel, most severe first. An empty list means no active alerts. - [NOAA API: List space weather alerts](https://fous.com/methods/swpc.noaa.gov/list-space-weather-alerts.md): Lists NOAA space weather alerts, warnings, watches and summaries issued in the last 1 to 7 days, newest first, with validity times and NOAA scale levels when the message gives them. - [NPS API: List park alerts](https://fous.com/methods/nps.gov/list-park-alerts.md): Lists current alerts for a named National Park Service park from its Current Conditions page, in the order shown on the page. - [MSN API: Get current weather](https://fous.com/methods/msn.com/get-current-weather.md): Gets current MSN Weather conditions for a city, address or ZIP code. The place is found through OpenStreetMap Nominatim. Matches for broad searches are approximate. - [AirNow API: Get air quality](https://fous.com/methods/airnow.gov/get-air-quality.md): Gets AirNow current air quality, pollutant readings and today's and tomorrow's forecasts for a US city or ZIP code, or a covered Canadian or Mexican city. - [All NWS methods](https://fous.com/methods/weather.gov.md)