GuidesAPI Reference
Guides

NWSAlertItemType

The structure NWSAlertItemsType represents the information about NWS weather warnings and weather watches.

ElementData typeDescription
typeInteger, see Supported NWS Warning or Watch TypesType of alert.
descriptionString, see also Supported NWS Warning or Watch TypesDescription of the alert.
severityIntegerThe severity of alerts from 1-100 with 1 being the most severe.
messageStringThe warning or watch text is a long string of words describing the warning or watch in detail.
nameStringLocation name.
zonesAlertZoneCountyTypeList of zones included with the alert. US only.
countiesAlertZoneCountyTypeList of counties included with the alert. US only.
provincesAlertProvinceTypeList of locations - provinces included with the alert. Canada only.
validFromTimeLocalDateTimeDate and time at the location the alert was issued by National Weather Service. The format is either YYYY-MM-DDThh:mm:ss.SSS + the timezone offset, unless the forecast is for a location in the UTC zone, in which the date and time is terminated by a Z.
validUntilTimeLocalDateTimeAlert expiration date and time at the location. The format is either YYYY-MM-DDThh:mm:ss.SSS + the timezone offset, unless the forecast is for a location in the UTC zone, in which the date and time is terminated by a Z.

One alert may impact multiple counties or zones across multiple states. Typically, a watch will impact significantly more locations than a warning.