GuidesAPI Reference
Guides

NWSAlertItemsType

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

ElementAttributeData typeDescription
typeInteger, see also Supported NWS Warning or Watch Types.Type 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 severity of alerts from 1-100 with 1 being the most severe.
zoneAlertLocationTypeList of zones included with the alert. US only[^1].
countyAlertLocationTypeList of counties included with the alert. US only[^1].
locationAlertLocationTypeList of locations included with the alert. Canada only[^1].
validFromTimeLocalDateDate 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.
validUntilTimeLocalDateAlert 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.
latitudeDoubleLatitude of location polygon centroid in degrees in WGS 84 format.
longitudeDoubleLongitude of location polygon centroid in degrees in WGS 84 format.
nameStringLocation name.
countryStringCountry name.
stateStringUS-state name.

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