> For the complete documentation index, see [llms.txt](https://api-v2-docs.disasteraware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-v2-docs.disasteraware.com/hazards/hazard-samples/storm-sample.md).

# Storm Sample

Storm hazards covering marine/coastal storm warnings, sourced from NWS and other agencies. Note: This type covers general storm warnings distinct from tropical cyclones, winter storms, and severe weather categories. These hazards aggregate multiple NWS alert products into a single consolidated hazard record.

## Storm-Specific Properties

### Incident Data

The `incident.properties` object for storm hazards follows the NWS alert format, containing metadata from the issuing weather service offices about the storm event and its expected conditions.

**Key incident properties for storms (NWS alert format) include:**

* `senderName` - Name of the issuing authority (e.g., "NWS Marquette MI")
* `headline` - Brief summary of the alert (e.g., "Storm Watch, Gale Watch, Gale Warnings and Small Craft Advisories...")
* `description` - Detailed description including individual alert text (may be very long for multi-alert events)
* `severity` - Severity classification (e.g., "WATCH")
* `urgency` - Urgency level (e.g., "Future")
* `certainty` - Certainty classification (e.g., "Possible")
* `event` - Event type descriptor ("Storm")
* `messagePhenomena` - NWS phenomena code ("SR" for Storm)
* `messageSignificance` - NWS significance code ("W" for Warning)
* `officeId` - Issuing NWS office identifier (e.g., "PAFC")
* `eventId` - NWS event identifier (e.g., "PAFC-SR-W-1054")
* `locationName` - Detailed description of affected geographic areas
* `areaDescription` - Human-readable area description matching locationName
* `affectedZoneIds` - List of NWS zone identifiers covered by the alert
* `geocode` - SAME and UGC zone code mappings for the alert area

### Features

The `features` property is `null` for this storm hazard. When NWS alert features are available through the enrichment pipeline, this property may contain CAP\_INFO features with alert polygon geometries representing individual alert areas.

### Exposure Areas

Single level - source-provided alert area. The `exposureAreas` FeatureCollection contains one feature with an `exposureLevel` property (e.g., level 2 for STRONG) covering the combined geographic extent of all consolidated storm warning zones.

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Storm - Lake Superior, northern Michigan and Isle Royale, United States"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "NWS Marquette MI has issued a Storm watch for March 16, 2026 00:00:00 UTC through March 17, 2026 06:00:00 UTC...."
    }
  ],
  "severity": "WATCH",
  "category": "EVENT",
  "incident": {
    "uuid": "9ed6ea4a-8766-451a-badd-e86406a092ae",
    "type": "STORM",
    "sourceId": 1801,
    "sourceRecordId": "b8c0ab98-a53f-4d64-8519-cd47a56cca41",
    "properties": {
      "senderName": "NWS Marquette MI",
      "urgency": "Future",
      "id": "urn:oid:2.49.0.1.840.0.c32136499bb124f5c75829611b3a379547836a61.002.4",
      "headline": "Storm Watch, Gale Watch, Gale Warnings and Small Craft Advisories for Lake Superior (Northern Michigan and Isle Royale), United States",
      "severity": "WATCH",
      "certainty": "Possible",
      "status": "Actual",
      "...": ""
    }
  },
  "uuid": "02aee4e9-2c51-4b4f-ba84-7296ddf2beb7",
  "comment": null,
  "createdAt": 1773433232,
  "relatedHazards": [],
  "longitude": -88.36131,
  "latitude": 47.12715,
  "version": 2,
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "MultiPolygon",
          "coordinates": [...]
        },
        "properties": null
      }
    ]
  },
  "features": null,
  "exposureAreas": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "MultiPolygon",
          "coordinates": [...]
        },
        "properties": {
          "exposureLevel": 2
        }
      }
    ]
  },
  "exposureAssessment": {
    "population": {
      "total": 201,
      "total0_14": 35,
      "total15_64": 131,
      "households": 81,
      "vulnerable": 24,
      "total65_Plus": 35
    },
    "capital": {
      "total": 906105300,
      "school": 0,
      "hospital": 0
    },
    "totalByCountry": [
      {
        "population": {
          "total": 0,
          "total0_14": 0,
          "total15_64": 0,
          "households": 0,
          "vulnerable": 0,
          "total65_Plus": 0
        },
        "country": "CAN",
        "capital": {
          "total": 0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Canada",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 0.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 0.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 0.0
      },
      {
        "population": {
          "total": 201,
          "total0_14": 35,
          "total15_64": 131,
          "households": 81,
          "vulnerable": 24,
          "total65_Plus": 35
        },
        "country": "USA",
        "capital": {
          "total": 906105300,
          "school": 0,
          "hospital": 0
        },
        "admin0": "United States",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "MRE",
        "foodNeeds": 48.2,
        "waterNeedsUnit": "gal",
        "waterNeeds": 19.09925,
        "wasteNeedsUnit": "25 gal",
        "wasteNeeds": 2.41,
        "shelterNeedsUnit": "sq feet",
        "shelterNeeds": 276.668
      }
    ],
    "totalByAdmin": [
      {
        "population": {
          "total": 201,
          "total0_14": 35,
          "total15_64": 131,
          "households": 81,
          "vulnerable": 24,
          "total65_Plus": 35
        },
        "country": "USA",
        "capital": {
          "total": 906105300,
          "school": 0,
          "hospital": 0
        },
        "admin0": "United States",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "MRE",
        "foodNeeds": 48.2,
        "waterNeedsUnit": "gal",
        "waterNeeds": 19.09925,
        "wasteNeedsUnit": "25 gal",
        "wasteNeeds": 2.41,
        "shelterNeedsUnit": "sq feet",
        "shelterNeeds": 276.668
      },
      {
        "population": {
          "total": 0,
          "total0_14": 0,
          "total15_64": 0,
          "households": 0,
          "vulnerable": 0,
          "total65_Plus": 0
        },
        "country": "CAN",
        "capital": {
          "total": 0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Canada",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 0.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 0.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 0.0
      }
    ],
    "exposureLevels": [
      {
        "level": "2",
        "data": {
          "population": {
            "total": 201,
            "total0_14": 35,
            "total15_64": 131,
            "households": 81,
            "vulnerable": 24,
            "total65_Plus": 35
          },
          "capital": {
            "total": 906105300,
            "school": 0,
            "hospital": 0
          },
          "totalByCountry": [
            {
              "population": {
                "total": 0,
                "total0_14": 0,
                "total15_64": 0,
                "households": 0,
                "vulnerable": 0,
                "total65_Plus": 0
              },
              "country": "CAN",
              "capital": {
                "total": 0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 0.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 0.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 0.0
            },
            {
              "population": {
                "total": 201,
                "total0_14": 35,
                "total15_64": 131,
                "households": 81,
                "vulnerable": 24,
                "total65_Plus": 35
              },
              "country": "USA",
              "capital": {
                "total": 906105300,
                "school": 0,
                "hospital": 0
              },
              "admin0": "United States",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "MRE",
              "foodNeeds": 48.2,
              "waterNeedsUnit": "gal",
              "waterNeeds": 19.09925,
              "wasteNeedsUnit": "25 gal",
              "wasteNeeds": 2.41,
              "shelterNeedsUnit": "sq feet",
              "shelterNeeds": 276.668
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 0,
                "total0_14": 0,
                "total15_64": 0,
                "households": 0,
                "vulnerable": 0,
                "total65_Plus": 0
              },
              "country": "CAN",
              "capital": {
                "total": 0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 0.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 0.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 0.0
            },
            {
              "population": {
                "total": 201,
                "total0_14": 35,
                "total15_64": 131,
                "households": 81,
                "vulnerable": 24,
                "total65_Plus": 35
              },
              "country": "USA",
              "capital": {
                "total": 906105300,
                "school": 0,
                "hospital": 0
              },
              "admin0": "United States",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "MRE",
              "foodNeeds": 48.2,
              "waterNeedsUnit": "gal",
              "waterNeeds": 19.09925,
              "wasteNeedsUnit": "25 gal",
              "wasteNeeds": 2.41,
              "shelterNeedsUnit": "sq feet",
              "shelterNeeds": 276.668
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 50610.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 72.3,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 2.41,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 83.145
        },
        "exposureDescription": "STRONG"
      }
    ],
    "hazardUuid": "",
    "hazardType": "",
    "version": "",
    "timestamp": "1773433216842",
    "exposureDescription": "",
    "foodNeedsUnit": "CAL",
    "foodNeeds": 50610.0,
    "waterNeedsUnit": "liter",
    "waterNeeds": 72.3,
    "wasteNeedsUnit": "100 liter",
    "wasteNeeds": 2.41,
    "shelterNeedsUnit": "sq meters",
    "shelterNeeds": 83.145
  },
  "type": "STORM",
  "creator": "RICHTER",
  "source": null,
  "startedAt": 1773619200,
  "updatedAt": 1773433216,
  "endedAt": 1773727200
}
```

{% hint style="info" %}
Note: Coordinate arrays have been replaced with `[...]` for brevity. In actual API responses, `alertGeometry` and `exposureAreas` contain complete GeoJSON coordinate arrays. The `incident.properties` object has been truncated with `"..."` to show only key fields; the full `description` field contains text from all consolidated NWS alert products. The `features` property is `null` for this hazard. The `source` field is `null` for NWS storm hazards. Population values within `exposureAssessment` are integers; `capital.school` and `capital.hospital` are counts of exposed facilities.
{% endhint %}