How to filter for hurricane alert data

[bfellerath]

Hi, I am trying to filter for hurricane alert data. What would be the best way to do this?

I know the types endpoint (https://api.weather.gov/alerts/types) gives a list of alert types that include some hurricane types:

    "Hurricane Force Wind Warning",
    "Hurricane Force Wind Watch",
    "Hurricane Local Statement",
    "Hurricane Warning",
    "Hurricane Watch",

I am wondering how to hit an endpoint that will give me hurricane types specifically

Other than that I was looking into using the "event" property for this

[scadergit]

The API spec provides the possible parameters for alert endpoints. You can use the "event" parameter with the full event name, but probably better to use the "code" parameter. Either support a comma-separated list of names/codes. Here is the spec for codes:

            "name": "code",
            "in": "query",
            "description": "Event code",
            "schema": {
              "type": "array",
              "items": {
                "type": "string",
                "format": "^\\w{3}$"
              }
            },
            "style": "form",
            "explode": false
          },

Alerts are created by NWS HCE (HazCollect Extended), and the API simply disseminates them. Given I can't find a list online by HCE, here is a list I got from them previously through email:

AQA=Air Quality Alert|Unknown|Unknown|Unknown|Monitor|NWS|||ALL,CMAS,EAS,NWEM
AVA=Avalanche Watch|Unknown|Unknown|Unknown|Monitor|AVA|||ALL,CMAS,EAS,NWEM
AVW=Avalanche Warning|Unknown|Unknown|Unknown|Monitor|AVW|||ALL,CMAS,EAS,NWEM
CAE=Child Abduction Emergency|Unknown|Unknown|Unknown|Monitor|CAE|||ALL,CMAS,EAS,NWEM
CDW=Civil Danger Warning|Unknown|Unknown|Unknown|Monitor|CDW|||ALL,CMAS,EAS,NWEM
CEM=Civil Emergency Message|Unknown|Unknown|Unknown|Monitor|CEM|||ALL,CMAS,EAS,NWEM
CFW.BH.S=Beach Hazards Statement|Expected|Moderate|Likely|Avoid|NWS|||CMAS,EAS,NWEM
CFW.CF.A=Coastal Flood Watch|Future|Moderate|Possible|Prepare|CFA|||CMAS,EAS,NWEM
CFW.CF.S=Coastal Flood Statement|Expected|Minor|Likely|Monitor|NWS|||CMAS,EAS,NWEM
CFW.CF.W=Coastal Flood Warning|Expected|Severe|Likely|Avoid|CFW|||CMAS,EAS,NWEM
CFW.CF.Y=Coastal Flood Advisory|Expected|Minor|Likely|Monitor|NWS|||CMAS,EAS,NWEM
CFW.LS.A=Lakeshore Flood Watch|Future|Moderate|Possible|Prepare|CFA|||CMAS,EAS,NWEM
CFW.LS.S=Lakeshore Flood Statement|Expected|Minor|Likely|Monitor|NWS|||CMAS,EAS,NWEM
CFW.LS.W=Lakeshore Flood Warning|Expected|Severe|Likely|Avoid|CFW|||CMAS,EAS,NWEM
CFW.LS.Y=Lakeshore Flood Advisory|Expected|Minor|Likely|Monitor|NWS|||CMAS,EAS,NWEM
CFW.RP.S=Rip Current Statement|Expected|Moderate|Likely|Avoid|NWS|||CMAS,EAS,NWEM
CFW.SU.W=High Surf Warning|Expected|Moderate|Likely|Avoid|NWS|||CMAS,EAS,NWEM
CFW.SU.Y=High Surf Advisory|Expected|Minor|Likely|Avoid|NWS|||CMAS,EAS,NWEM
DSW.DS.W=Dust Storm Warning|Expected|Severe|Likely|Avoid|DSW||FALSE|EAS,NWEM
DSW.DS.Y=Dust Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
EQW=Earthquake Warning|Unknown|Unknown|Unknown|Monitor|EQW|||ALL,CMAS,EAS,NWEM
ESF=Hydrologic Outlook|Future|Unknown|Possible|Monitor|NWS|||CMAS,EAS,NWEM
EVI=Evacuation - Immediate|Unknown|Unknown|Unknown|Monitor|EVI|||ALL,CMAS,EAS,NWEM
EWW.EW.W=Extreme Wind Warning|Immediate|Extreme|Observed|Shelter|EWW||FALSE|EAS,NWEM
FFA.FA.A=Flood Watch|Future|Severe|Possible|Prepare|FFA|||CMAS,EAS,NWEM
FFA.FF.A=Flash Flood Watch|Future|Severe|Possible|Monitor|FFA|||CMAS,EAS,NWEM
FFA.FL.A=Flood Watch|Future|Severe|Possible|Prepare|FLA|||CMAS,EAS,NWEM
FFS.FF.W=Flash Flood Warning|Immediate|Severe|Likely|Avoid|FFS|||CMAS,EAS,NWEM
FFS.FF.W.IBW=Flash Flood Warning|Immediate|Severe|Likely|Avoid|FFS|||CMAS,EAS,NWEM
FFWEMER=Flash Flood Warning|Immediate|Severe|Likely|Avoid|FFW||FALSE|EAS,NWEM
FFW.FF.W=Flash Flood Warning|Immediate|Severe|Likely|Avoid|FFW||FALSE|EAS,NWEM
FFW.FF.W.IBW=Flash Flood Warning|Immediate|Severe|Likely|Avoid|FFW||FALSE|CMAS,EAS,NWEM
FLS.FA.W=Flood Warning|Immediate|Severe|Likely|Avoid|FLS|||CMAS,EAS,NWEM
FLS.FA.Y=Flood Advisory|Expected|Minor|Likely|Avoid|NWS|||CMAS,EAS,NWEM
FLS.FL.W=Flood Warning|Immediate|Severe|Observed|Avoid|FLS|||CMAS,EAS,NWEM
FLS.FL.Y=Flood Advisory|Expected|Minor|Observed|Avoid|NWS|||CMAS,EAS,NWEM
FLW.FA.W=Flood Warning|Expected|Severe|Likely|Avoid|FLW|||CMAS,EAS,NWEM
FLW.FL.W=Flood Warning|Expected|Severe|Likely|Avoid|FLW|||CMAS,EAS,NWEM
FRW=Fire Warning|Unknown|Unknown|Unknown|Monitor|FRW|||ALL,CMAS,EAS,NWEM
HLS.HU.A=Hurricane Watch|Future|Severe|Possible|Prepare|HUA|||CMAS,EAS,NWEM
HLS.HU.S=Tropical Cyclone Statement|Expected|Moderate|Likely|Monitor|NWS|||CMAS,EAS,NWEM
HLS.HU.W=Hurricane Warning|Immediate|Extreme|Likely|Avoid|HUW||FALSE|EAS,NWEM
HLS.TR.A=Tropical Storm Watch|Future|Severe|Possible|Prepare|TRA|||CMAS,EAS,NWEM
HLS.TR.W=Tropical Storm Warning|Immediate|Severe|Observed|Avoid|TRW|||CMAS,EAS,NWEM
HLS.TY.A=Typhoon Watch|Future|Severe|Possible|Prepare|HUA|||CMAS,EAS,NWEM
HLS.TY.S=Typhoon Local Statement|Expected|Moderate|Likely|Monitor|HLS|||CMAS,EAS,NWEM
HLS.TY.W=Typhoon Warning|Immediate|Extreme|Likely|Avoid|HUW||FALSE|EAS,NWEM
HLS=Tropical Cyclone Statement|Expected|Moderate|Likely|Monitor|HLS|||CMAS,EAS,NWEM
HMW=Hazardous Materials Warning|Unknown|Unknown|Unknown|Monitor|HMW|||ALL,CMAS,EAS,NWEM
LAE=Local Area Emergency|Unknown|Unknown|Unknown|Monitor|LAE|||ALL,CMAS,EAS,NWEM
LEW=Law Enforcement Warning|Unknown|Unknown|Unknown|Monitor|LEW|||ALL,CMAS,EAS,NWEM
MWS.MA.W=Special Marine Warning|Immediate|Severe|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWS=Marine Weather Statement|Expected|Minor|Observed|Monitor|NWS|||CMAS,EAS,NWEM
MWW.BW.Y=Brisk Wind Advisory|Expected|Minor|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.GL.A=Gale Watch|Future|Moderate|Possible|Prepare|NWS|||CMAS,EAS,NWEM
MWW.GL.W=Gale Warning|Expected|Moderate|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.HF.A=Hurricane Force Wind Watch|Future |Severe|Possible|Prepare|NWS|||CMAS,EAS,NWEM
MWW.HF.W=Hurricane Force Wind Warning|Immediate|Extreme|Observed|Avoid|NWS|||CMAS,EAS,NWEM
MWW.HU.A=Hurricane Watch|Future|Severe|Possible|Prepare|HUA|||CMAS,EAS,NWEM
MWW.HU.W=Hurricane Warning|Immediate|Extreme|Likely|Avoid|HUW||FALSE|EAS,NWEM
MWW.LO.Y=Low Water Advisory|Expected|Minor|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.MF.Y=Dense Fog Advisory|Expected|Minor|Likely|Prepare|NWS|||CMAS,EAS,NWEM
MWW.MH.W=Ashfall Warning|Expected|Moderate|Likely|Monitor|NWS|||CMAS,EAS,NWEM
MWW.MH.Y=Ashfall Advisory|Expected|Minor|Likely|Monitor|NWS|||CMAS,EAS,NWEM
MWW.MS.Y=Dense Smoke Advisory|Expected|Minor|Likely|Prepare|NWS|||CMAS,EAS,NWEM
MWW.RB.Y=Small Craft Advisory for Rough Bar|Expected|Minor|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.SC.Y=Small Craft Advisory|Expected|Minor|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.SE.A=Hazardous Seas Watch|Future|Moderate|Possible|Prepare|NWS|||CMAS,EAS,NWEM
MWW.SE.W=Hazardous Seas Warning|Expected|Moderate|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.SI.Y=Small Craft Advisory for Winds|Expected|Minor|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.SR.A=Storm Watch|Future|Severe|Possible|Prepare|NWS|||CMAS,EAS,NWEM
MWW.SR.W=Storm Warning|Immediate|Severe|Observed|Avoid|NWS|||CMAS,EAS,NWEM
MWW.SW.Y=Small Craft Advisory for Hazardous Seas|Expected|Minor|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.TR.A=Tropical Storm Watch|Future|Severe|Possible|Prepare|TRA|||CMAS,EAS,NWEM
MWW.TR.W=Tropical Storm Warning|Immediate|Severe|Observed|Avoid|TRW|||CMAS,EAS,NWEM
MWW.TY.A=Typhoon Watch|Future|Severe|Possible|Prepare|HUA|||CMAS,EAS,NWEM
MWW.TY.W=Typhoon Warning|Immediate|Extreme|Likely|Avoid|HUW||FALSE|EAS,NWEM
MWW.UP.A=Heavy Freezing Spray Watch|Future|Moderate|Possible|Prepare|NWS|||CMAS,EAS,NWEM
MWW.UP.W=Heavy Freezing Spray Warning|Expected|Severe|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.UP.Y=Heavy Freezing Spray Advisory|Expected|Moderate|Likely|Avoid|NWS|||CMAS,EAS,NWEM
MWW.ZY.Y=Freezing Spray Advisory|Expected|Moderate|Likely|Prepare|NWS|||CMAS,EAS,NWEM
NPW.AF.Y=Ashfall Advisory|Expected|Moderate|Likely|Monitor|NWS|||CMAS,EAS,NWEM
NPW.AS.Y=Air Stagnation Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.DS.W=Dust Storm Warning|Expected|Severe|Likely|Avoid|DSW|||CMAS,EAS,NWEM
NPW.DU.Y=Blowing Dust Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.DU.W=Blowing Dust Warning|Expected|Severe|Likely|Avoid|NWS|||CMAS,EAS,NWEM
NPW.EC.A=Extreme Cold Watch|Future|Extreme|Likely|Monitor|WSA|||CMAS,EAS,NWEM
NPW.EC.W=Extreme Cold Warning (Alaska only)|Expected|Severe|Likely|Prepare|WSW|||CMAS,EAS,NWEM
NPW.EH.A=Excessive Heat Watch|Future|Severe|Likely|Monitor|NWS|||CMAS,EAS,NWEM
NPW.EH.W=Excessive Heat Warning|Expected|Severe|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.FG.Y=Dense Fog Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.FR.Y=Frost Advisory|Expected|Minor|Likely|Prepare|NWS|||CMAS,EAS,NWEM
NPW.FZ.A=Freeze Watch|Future|Severe|Possible|Prepare|NWS|||CMAS,EAS,NWEM
NPW.FZ.W=Freeze Warning|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.HT.Y=Heat Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.HW.A=High Wind Watch|Future|Severe|Possible|Prepare|HWA|||CMAS,EAS,NWEM
NPW.HW.W=High Wind Warning|Expected|Severe|Likely|Prepare|HWW|||CMAS,EAS,NWEM
NPW.HZ.A=Hard Freeze Watch|Future|Severe|Possible|Prepare|NWS|||CMAS,EAS,NWEM
NPW.HZ.W=Hard Freeze Warning|Expected|Severe|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.LW.Y=Lake Wind Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.SM.Y=Dense Smoke Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.WI.Y=Wind Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM
NPW.ZF.Y=Freezing Fog Advisory|Expected|Moderate|Likely|Avoid|NWS|||CMAS,EAS,NWEM
NUW=Nuclear Power Plant Warning|Unknown|Unknown|Unknown|Monitor|NUW|||ALL,CMAS,EAS,NWEM
RFD=Extreme Fire Danger|Expected|Moderate|Likely|Prepare|NWS|||CMAS,EAS,NWEM
RFW.FW.A=Fire Weather Watch|Future|Severe|Possible|Prepare|NWS|||CMAS,EAS,NWEM
RFW.FW.W=Red Flag Warning|Expected|Severe|Likely|Prepare|NWS|||CMAS,EAS,NWEM
RHW=Radiological Hazard Warning|Unknown|Unknown|Unknown|Monitor|RHW|||ALL,CMAS,EAS,NWEM
SAB=Avalanche Advisory|Unknown|Unknown|Unknown|Monitor|NWS|||CMAS,EAS,NWEM
SMW.MA.W=Special Marine Warning|Immediate|Severe|Likely|Avoid|SMW|||CMAS,EAS,NWEM
SPS=Special Weather Statement|Expected|Moderate|Observed|Execute|SPS|||CMAS,EAS,NWEM
SPW=Shelter In Place Warning|Unknown|Unknown|Unknown|Monitor|SPW|||ALL,CMAS,EAS,NWEM
SQW.SQ.W=Snow Squall Warning|Expected|Extreme|Likely|Avoid|SVS||FALSE|EAS,NWEM
SVR.SV.W=Severe Thunderstorm Warning|Immediate|Severe|Observed|Shelter|SVR|||CMAS,EAS,NWEM
SVS.EW.W=Extreme Wind Warning|Immediate|Extreme|Observed|Monitor|SVS|||CMAS,EAS,NWEM
SVS.SV.W=Severe Thunderstorm Warning|Immediate|Severe|Observed|Shelter|SVS|||CMAS,EAS,NWEM
SVS.TO.W=Tornado Warning|Immediate|Extreme|Observed|Shelter|SVS|||CMAS,EAS,NWEM
TCV.HU.A=Hurricane Watch|Future|Severe|Possible|Prepare|HUA|||CMAS,EAS,NWEM
TCV.HU.W=Hurricane Warning|Immediate|Extreme|Likely|Avoid|HUW||FALSE|EAS,NWEM
TCV.SS.A=Storm Surge Watch|Future|Severe|Possible|Prepare|SSA|||CMAS,EAS,NWEM
TCV.SS.W=Storm Surge Warning|Expected|Extreme|Likely|Avoid|SSW||FALSE|EAS,NWEM
TCV.TR.A=Tropical Storm Watch|Future|Severe|Possible|Prepare|TRA|||CMAS,EAS,NWEM
TCV.TR.W=Tropical Storm Warning|Immediate|Severe|Observed|Avoid|TRW|||CMAS,EAS,NWEM
TCV.TY.A=Typhoon Watch|Future|Severe|Possible|Prepare|HUA|||CMAS,EAS,NWEM
TCV.TY.W=Typhoon Warning|Immediate|Extreme|Likely|Avoid|HUW||FALSE|EAS,NWEM
TOE=911 Telephone Outage|Unknown|Unknown|Unknown|Monitor|TOE|||ALL,CMAS,EAS,NWEM
TOR.TO.W=Tornado Warning|Immediate|Extreme|Observed|Shelter|TOR||FALSE|EAS,NWEM
TOREMER=Tornado Warning|Immediate|Extreme|Observed|Shelter|TOR||TRUE|EAS,NWEM
TSU.TS.A=Tsunami Watch|Future|Extreme|Possible|Monitor|TSA|||CMAS,EAS,NWEM,PUBLIC
TSU.TS.W=Tsunami Warning|Immediate|Extreme|Likely|Avoid|TSW||FALSE|EAS,NWEM,PUBLIC
TSU.TS.Y=Tsunami Advisory|Future|Moderate|Possible|Prepare|NWS|||CMAS,EAS,NWEM,PUBLIC
VOW=Volcano Warning|Unknown|Unknown|Unknown|Monitor|VOW|||ALL,CMAS,EAS,NWEM
WCN.SV.A=Severe Thunderstorm Watch|Future|Severe|Possible|Monitor|SVA|||CMAS,EAS,NWEM
WCN.TO.A=Tornado Watch|Future|Extreme|Possible|Monitor|TOA|||CMAS,EAS,NWEM
WSW.BZ.W=Blizzard Warning|Expected|Extreme|Likely|Prepare|BZW||FALSE|CMAS,EAS,NWEM
WSW.IS.W=Ice Storm Warning|Expected|Extreme|Likely|Avoid|WSW||FALSE|CMAS,EAS,NWEM
WSW.LE.W=Lake Effect Snow Warning|Expected|Extreme|Likely|Avoid|WSW|||CMAS,EAS,NWEM
WSW.WC.A=Wind Chill Watch|Future|Severe|Likely|Monitor|NWS|||CMAS,EAS,NWEM
WSW.WC.W=Wind Chill Warning|Expected|Severe|Likely|Prepare|NWS|||CMAS,EAS,NWEM
WSW.WC.Y=Wind Chill Advisory|Expected|Moderate|Likely|Prepare|NWS|||CMAS,EAS,NWEM
WSW.WS.A=Winter Storm Watch|Future|Severe|Possible|Prepare|WSA|||CMAS,EAS,NWEM
WSW.WS.W=Winter Storm Warning|Expected|Severe|Likely|Prepare|WSW|||CMAS,EAS,NWEM
WSW.WW.Y=Winter Weather Advisory|Expected|Moderate|Likely|Execute|NWS|||CMAS,EAS,NWEM