{"uid":"cap_-3g3dfFnsTrMhvfq-zlcd","slug":"weather-alerts-by-state-nws-99ff0d7a","name":"Weather Alerts by State (NWS)","description":"Active NWS alerts for one US state or territory (full name, e.g. Colorado): event, severity, urgency, certainty, headline, area, onset and end times. From the NWS (US and territories), cached and refreshed about every 3 hours; a location not yet cached answers 404, is not charged, and is queued.","url":"https://api.maxwellinternational.ai/v1/weather/alerts-by-state?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"sku":"weather.alerts","cache":"hit","count":1,"match":true,"state":"Colorado","alerts":[{"id":"urn:oid:2.49.0.1.840.0.ce67801ec73048f07c44dd0418c6a50edd1c8fdc.001.1","ends":"2026-09-30T06:00:00-06:00","event":"Hydrologic Outlook","onset":"2026-09-25T14:21:00-06:00","urgency":"Future","areaDesc":"Archuleta, CO; Dolores, CO; Gunnison, CO; Hinsdale, CO; La Plata, CO; Montezu...","headline":"Hydrologic Outlook issued September 25 at 2:21PM MDT by NWS Grand Junction CO","severity":"Unknown","certainty":"Possible"}],"country":"United States","stateSlug":"colorado","generatedAt":"2026-09-26T04:01:03.586Z","nwsAreaCode":"CO","sourceClass":"official-api"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_tt-pY1ZTRn12gUA__w-nC","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns current National Weather Service weather alerts for a specified US state, including event type, severity, urgency, onset/end times, and affected areas.","exampleAgentPrompt":"Can you pull the current NWS weather alerts for Colorado and tell me if there's anything severe or urgent I should know about?","exampleUseCases":[{"title":"Emergency alert monitoring for road trip","prompt":"I'm driving through Colorado and New Mexico tomorrow — can you check if there are any active weather alerts, especially anything urgent or severe I should worry about?"},{"title":"Outdoor event safety check","prompt":"We have an outdoor wedding in La Plata County, Colorado this weekend — can you look up any current NWS weather alerts for Colorado and tell me the severity and what areas are affected?"},{"title":"Automated state-level weather dashboard","prompt":"Pull the latest official weather alerts for California and give me a summary of each alert's event type, severity, and how long it's in effect."}],"resultDescription":"Returns a JSON object containing the state name, NWS area code, a list of active weather alerts (each with event type, headline, severity, urgency, certainty, onset/end times, and affected area description), alert count, cache hit/miss status, and the timestamp the data was generated. Sourced from the official NWS API.","failureModes":["Invalid or unrecognized state name/slug returns an error or empty alert list","NWS upstream API unavailability may result in stale cache data or error response","State with no active alerts returns an empty alerts array with count 0","Malformed query parameters may return a 400 or validation error","Rate limiting or payment failure (x402) blocks the request"],"whenToPreferThis":"Choose this endpoint when you need official, authoritative NWS weather alert data scoped to a specific US state, including structured metadata like severity, urgency, certainty, and affected county-level areas. Prefer it over general weather APIs when you need emergency alert details (watches, warnings, outlooks) rather than forecasts or current conditions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T18:41:02.264Z","isFirstParty":false,"canonicalSlug":"weather-alerts-by-state-nws-99ff0d7a"}