> 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/wind-sample.md).

# Severe Wind Sample

This page provides a complete sample response for a live severe wind hazard from the [`/wind`](/hazards/requesting-wind.md) endpoint. Wind hazards are DisasterAWARE hazards of type `STORM` with `incident.properties.subType` of `WIND`, built from NWS severe thunderstorm warnings carrying a wind tag or damage threat, measured gusts, and wind damage reports. The record below is a real hazard from the convective day of 2026-10-22, in Graham County, Arizona: a measured 61 mph gust under a warning tagged with a destructive damage threat.

These hazards are returned by the [`/wind`](/hazards/requesting-wind.md) endpoint, which requires a specific role for wind feed access on your credentials.

## What makes this hazard

**Basis.** `windAssessment.wind_basis` is `gust_measured` — a measured gust of 58 mph or more. `damage_reported` means wind-damage reports or an estimated gust at that threshold, and `forecast_only` means a warning with no observed evidence yet. See [Requesting Wind Hazards](/hazards/requesting-wind.md#wind-basis).

**Gust.** `max_measured_gust_mph` is 61.0; the warning was tagged 70.0 mph.

**Damage threat.** `damage_threat` is `destructive`, the highest NWS damage-threat tag on the linked warnings. A `null` here means no warning carried a damage-threat tag — it does not mean no threat.

**Exposure.** Wind hazards carry a single level-1 Feature in `exposureAreas`: the footprint of the wind evidence.

**Lifecycle.** This is an ended record as held in history: `end_basis` is `warning_expired`, `incident.properties.endedAtKind` is `observed` and `isExpired` is `true`. While a hazard is active, `endedAt` is a projection, `endedAtKind` is `projected` and `end_basis` is `null`.

## Sample Response

```json
{
  "uuid": "1bd6e54f-2fdb-580b-9c51-0038773d187a",
  "type": "STORM",
  "category": "EVENT",
  "severity": "WARNING",
  "name": [
    {
      "locale": "en",
      "value": "Severe Wind — Graham [AZ]"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "Thunderstorm wind hazard 2026-10-21 23:39Z to 00:25Z; measured gust up to 61 mph; NWS warning TWC.SV.0309.2026 (wind tag 70 mph, damage threat destructive)."
    }
  ],
  "comment": "",
  "creator": "DataFeeds Enhancement Pipeline",
  "source": null,
  "latitude": 32.69245,
  "longitude": -109.71,
  "startedAt": 1792625940,
  "endedAt": 1792628700,
  "createdAt": 1792782680,
  "updatedAt": 1792782763,
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            "..."
          ]
        },
        "properties": null
      }
    ]
  },
  "legacy_hazard_id": null,
  "location": {
    "admin0": "United States of America",
    "admin0_iso2": "US",
    "admin0_iso3": "USA",
    "admin1": "Arizona",
    "admin1_code": "US-AZ",
    "admin2": "Graham",
    "admin2_code": "04009",
    "continent": "North America",
    "subregion": "Northern America",
    "location_type": "land",
    "source": "local_geocoder"
  },
  "incident": {
    "uuid": "1bd6e54f-2fdb-580b-9c51-0038773d187a",
    "type": "STORM",
    "sourceId": null,
    "sourceRecordId": null,
    "properties": {
      "name": "Severe Wind — Graham [AZ]",
      "description": "Thunderstorm wind hazard 2026-10-21 23:39Z to 00:25Z; measured gust up to 61 mph; NWS warning TWC.SV.0309.2026 (wind tag 70 mph, damage threat destructive).",
      "hazardDescription": "Thunderstorm wind hazard 2026-10-21 23:39Z to 00:25Z; measured gust up to 61 mph; NWS warning TWC.SV.0309.2026 (wind tag 70 mph, damage threat destructive).",
      "headline": "Severe Wind — Graham [AZ]: measured gust 61 mph",
      "locationName": "Graham [AZ]",
      "areaDescription": "Graham [AZ]",
      "shortenedAreaDescription": "Graham [AZ]",
      "event": "Thunderstorm Wind",
      "sentAt": 1792625940,
      "onsetAt": 1792625940,
      "isExpired": true,
      "expiresAt": 1792628700,
      "expiredAt": 1792628700,
      "phenomena": [
        "thunderstorm",
        "wind"
      ],
      "phenomenaBasis": {
        "thunderstorm": [
          "report",
          "vtec"
        ],
        "wind": [
          "measured",
          "report"
        ]
      },
      "endedAtKind": "observed",
      "recordOrigin": "live",
      "subType": "WIND",
      "source": "live_wind",
      "sender": null,
      "certainty": null,
      "urgency": null,
      "severity": null,
      "senderName": null,
      "instruction": null
    }
  },
  "windAssessment": {
    "wind_event_key": "nws:TWC.SV.0309.2026",
    "max_warning_wind_tag_mph": 70.0,
    "damage_threat": "destructive",
    "max_measured_gust_mph": 61.0,
    "max_gust_mph": 61.0,
    "total_damage_reports": 0,
    "total_gust_reports": 2,
    "total_measured": 1,
    "wind_basis": "gust_measured",
    "total_reports": 2,
    "exposure_levels": {
      "1": "observed wind-evidence footprint (damage reports, gusts >= 58 mph)"
    },
    "end_basis": "warning_expired",
    "sources_consulted": [
      {
        "source": "NWS warnings (api.weather.gov CAP/VTEC)",
        "status": "observed"
      },
      {
        "source": "IEM LSR + SPC preliminary reports + ASOS gusts",
        "status": "observed"
      }
    ],
    "enhancedAt": 1792782839,
    "enhancer": "scs-live@f5c3606"
  },
  "windDetails": {
    "wind_reports": [
      {
        "source": "LSR",
        "kind": "gust",
        "time_utc": "2026-10-21T23:46:00Z",
        "lat": 32.69,
        "lon": -109.71,
        "speed_mph": 61.0,
        "qualifier": "M",
        "city": "10 S Safford",
        "state": "AZ",
        "remark": "Measured peak wind gust of 61 mph."
      },
      {
        "source": "SPC",
        "kind": "gust",
        "time_utc": "2026-10-21T23:46:00Z",
        "lat": 32.69,
        "lon": -109.71,
        "speed_mph": 61.0,
        "qualifier": null,
        "city": "10 S Safford",
        "state": "AZ",
        "remark": "Measured peak wind gust of 61 mph. (TWC)"
      }
    ],
    "warnings": [
      {
        "vtec": "TWC.SV.0309.2026",
        "event_id": "KTWC-SV-W-0309",
        "office": "KTWC",
        "phenomenon": "SV",
        "issued_utc": "2026-10-21T23:39:00Z",
        "expires_utc": "2026-10-22T00:30:00Z",
        "ended_utc": "2026-10-22T00:25:00Z",
        "vtec_action": "EXP",
        "cap_message_type": "Update",
        "hail_tag_in": 2.75,
        "wind_tag_mph": 70.0,
        "damage_threat": "destructive",
        "tornado_tag": "POSSIBLE",
        "opens_hazard": true,
        "current_polygon": {
          "type": "Polygon",
          "coordinates": [
            "..."
          ]
        },
        "versions": [
          {
            "vtec_action": "NEW",
            "time_utc": "2026-10-21T23:39:00Z",
            "expires_utc": "2026-10-22T00:30:00Z",
            "cap_id": "urn:oid:2.49.0.1.840.0.effe456c9b3d8ee76eba120462f4711f27b3a9a2.001.1",
            "cap_message_type": "Alert",
            "hail_tag_in": 2.0,
            "wind_tag_mph": 70.0,
            "damage_threat": "considerable",
            "tornado_tag": "POSSIBLE",
            "area_km2": 1482.0,
            "polygon": {
              "type": "Polygon",
              "coordinates": [
                "..."
              ]
            }
          },
          "..."
        ]
      }
    ],
    "report_timeline": [
      {
        "t": "2026-10-21T23:46:00Z",
        "reports_total": 2,
        "damage_reports": 0,
        "max_gust_mph": 61.0,
        "max_measured_gust_mph": 61.0,
        "hull": {
          "type": "Polygon",
          "coordinates": [
            "..."
          ]
        }
      }
    ],
    "enhancedAt": 1792782839,
    "enhancer": "scs-live@f5c3606"
  },
  "relatedHazards": [],
  "features": null,
  "exposureAssessment": {},
  "exposureAreas": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "exposureLevel": 1
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [
            "..."
          ]
        }
      }
    ]
  },
  "version": 2
}
```

{% hint style="info" %}
Coordinate arrays have been replaced with `[...]` for brevity; in actual API responses they contain complete GeoJSON coordinate arrays. Repeated array entries — reports, warnings, radar frames and timeline steps — are shown as the first entry followed by `"..."`, and long text fields are truncated. Every `exposureAreas` Feature is shown, since the levels are the point of the record. `exposureAssessment` is `{}` on both of these records: the live hail and wind feeds carry the observed footprint in `exposureAreas` rather than a population and capital assessment. Every other value is verbatim from a live record of 2026-10-22.
{% endhint %}