# High Wind Sample

This page provides a complete sample response for a high wind hazard from the Active Hazards API endpoint. High wind hazards include strong wind warnings, gale warnings, and wind advisories issued by national meteorological services. These alerts follow the Common Alerting Protocol (CAP) standard and are sourced from agencies such as Environment Canada, the U.S. National Weather Service (NWS), and the Australian Government Bureau of Meteorology (BoM).

## High Wind-Specific Properties

### Incident Data

The `incident.properties` object for a high wind hazard contains standard CAP alert metadata. Key incident properties include:

* `senderName` - Issuing agency (e.g., `"Environment Canada"`)
* `headline` - Alert headline text describing the wind warning and affected areas
* `description` - Detailed alert description with wind speed information and expected impacts
* `severity` - CAP severity level (e.g., `"Moderate"`)
* `urgency` - CAP urgency level (e.g., `"Future, Past"`)
* `certainty` - CAP certainty level (e.g., `"Likely, Observed"`)
* `event` - Event type name (e.g., `"Wind"`)
* `effective` / `expires` / `onset` - ISO 8601 timing fields for the alert window
* `msgType` - CAP message type (e.g., `"Update"`)
* `instruction` - Recommended actions (may be empty)
* `category` - CAP category (e.g., `"Met"` for meteorological)
* `hazardSeverity` - Hazard severity classification (e.g., `"WARNING"`)
* `incidentLocationName` - Human-readable location (e.g., `"St. John's, Newfoundland and Labrador, Canada"`)
* `headlineDescription` - Full descriptive headline combining alert status and wind details

### Features

The `features` property contains a GeoJSON FeatureCollection with `EXPOSURE_AREA` and `SMART_ALERT` features. Each EXPOSURE\_AREA feature represents a zone with a specific severity level (e.g., LIMITED, MODERATE). The collection may also include CAP\_INFO features with area descriptions and geocodes in the full response.

### Exposure Areas

High wind hazards may use multiple exposure levels representing different severity zones:

* **Level 0**: Limited exposure area - peripheral zone with lower expected impact
* **Level 1**: Moderate exposure area - core zone with higher expected impact

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Wind - St. John's, Newfoundland and Labrador, Canada"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "Environment Canada has issued a Wind warning for March 13, 2026 18:18:24 UTC through March 14, 2026 02:02:24 UTC.\n\nIt is estimated that 293,000 people, 129,000 households, and $48.7 Billion (USD) of infrastructure* are within the affected area(s). Exposure estimates will be refined as additional data from official sources becomes available.\n\nyellow warning - wind - in effect\nStrong winds that may cause damage are expected. Locations: Avalon Peninsula. Maximum wind gusts: southwesterly 100 km/h..."
    }
  ],
  "severity": "WARNING",
  "category": "EVENT",
  "incident": {
    "uuid": "2f7c390d-7581-448f-89a3-1b2c065ed416",
    "type": "HIGHWIND",
    "sourceId": 1800,
    "sourceRecordId": "urn:oid:2.49.0.1.124.1146677353.2026",
    "properties": {
      "hazardName": "Wind - St. John's, Newfoundland and Labrador, Canada",
      "senderName": "Environment Canada",
      "urgency": "Future, Past",
      "headline": "yellow warning - wind - in effect\nyellow warning - wind - ended",
      "severity": "Moderate",
      "certainty": "Likely, Observed",
      "status": null,
      "..."
    }
  },
  "uuid": "36fc56ba-1234-4320-8516-8a10b74671fa",
  "comment": null,
  "createdAt": 1773426710,
  "relatedHazards": [],
  "longitude": -54.21334,
  "latitude": 47.15707,
  "version": 7,
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "properties": null
      }
    ]
  },
  "features": {
    "features": [
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "severity": "LIMITED",
          "featureType": "EXPOSURE_AREA",
          "type": "EXPOSURE_AREA"
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "incidentType": null,
        "sourceId": null
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "severity": "MODERATE",
          "featureType": "EXPOSURE_AREA",
          "type": "EXPOSURE_AREA"
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "incidentType": null,
        "sourceId": null
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "featureType": "SMART_ALERT",
          "type": "SMART_ALERT"
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "incidentType": null,
        "sourceId": null
      }
    ],
    "incidentType": null,
    "metadata": null,
    "type": "FeatureCollection",
    "sourceId": null
  },
  "exposureAreas": {
    "features": [
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "exposureLevel": 0
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "sourceId": null
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "exposureLevel": 1
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "sourceId": null
      }
    ],
    "type": "FeatureCollection"
  },
  "exposureAssessment": {
    "population": {
      "total": 293000,
      "total0_14": 44829,
      "total15_64": 191417,
      "total65_Plus": 56696,
      "households": 129075,
      "vulnerable": 29300
    },
    "capital": {
      "total": 48711958700,
      "school": 29,
      "hospital": 18
    },
    "totalByCountry": [
      {
        "population": {
          "total": 293000,
          "total0_14": 44829,
          "total15_64": 191417,
          "total65_Plus": 56696,
          "households": 129075,
          "vulnerable": 29300
        },
        "country": "CAN",
        "capital": {
          "total": 48711958700,
          "school": 29,
          "hospital": 18
        },
        "admin0": "Canada",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 61530000.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 87900.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 2930.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 101085.0
      }
    ],
    "totalByAdmin": [
      {
        "population": {
          "total": 293000,
          "total0_14": 44829,
          "total15_64": 191417,
          "total65_Plus": 56696,
          "households": 129075,
          "vulnerable": 29300
        },
        "country": "CAN",
        "capital": {
          "total": 48711958700,
          "school": 29,
          "hospital": 18
        },
        "admin0": "Canada",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 61530000.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 87900.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 2930.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 101085.0
      }
    ],
    "exposureLevels": [
      {
        "level": "0",
        "data": {
          "population": {
            "total": 15900,
            "total0_14": 2433,
            "total15_64": 10387,
            "total65_Plus": 3077,
            "households": 7004,
            "vulnerable": 1590
          },
          "capital": {
            "total": 3164208600,
            "school": 16,
            "hospital": 4
          },
          "totalByCountry": [
            {
              "population": {
                "total": 15900,
                "total0_14": 2433,
                "total15_64": 10387,
                "total65_Plus": 3077,
                "households": 7004,
                "vulnerable": 1590
              },
              "country": "CAN",
              "capital": {
                "total": 3164208600,
                "school": 16,
                "hospital": 4
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 3339000.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 4770.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 159.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 5485.5
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 15900,
                "total0_14": 2433,
                "total15_64": 10387,
                "total65_Plus": 3077,
                "households": 7004,
                "vulnerable": 1590
              },
              "country": "CAN",
              "capital": {
                "total": 3164208600,
                "school": 16,
                "hospital": 4
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 3339000.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 4770.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 159.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 5485.5
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 3339000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 4770.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 159.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 5485.5
        },
        "exposureDescription": "LIMITED"
      },
      {
        "level": "1",
        "data": {
          "population": {
            "total": 277000,
            "total0_14": 42381,
            "total15_64": 180964,
            "total65_Plus": 53600,
            "households": 122026,
            "vulnerable": 27700
          },
          "capital": {
            "total": 45547750100,
            "school": 13,
            "hospital": 14
          },
          "totalByCountry": [
            {
              "population": {
                "total": 277000,
                "total0_14": 42381,
                "total15_64": 180964,
                "total65_Plus": 53600,
                "households": 122026,
                "vulnerable": 27700
              },
              "country": "CAN",
              "capital": {
                "total": 45547750100,
                "school": 13,
                "hospital": 14
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 58170000.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 83100.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 2770.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 95565.0
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 277000,
                "total0_14": 42381,
                "total15_64": 180964,
                "total65_Plus": 53600,
                "households": 122026,
                "vulnerable": 27700
              },
              "country": "CAN",
              "capital": {
                "total": 45547750100,
                "school": 13,
                "hospital": 14
              },
              "admin0": "Canada",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 58170000.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 83100.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 2770.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 95565.0
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 58170000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 83100.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 2770.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 95565.0
        },
        "exposureDescription": "MODERATE"
      }
    ],
    "hazardUuid": "",
    "hazardType": "",
    "version": "",
    "timestamp": "1773426695153",
    "exposureDescription": "",
    "foodNeedsUnit": "CAL",
    "foodNeeds": 61530000.0,
    "waterNeedsUnit": "liter",
    "waterNeeds": 87900.0,
    "wasteNeedsUnit": "100 liter",
    "wasteNeeds": 2930.0,
    "shelterNeedsUnit": "sq meters",
    "shelterNeeds": 101085.0
  },
  "type": "HIGHWIND",
  "creator": "RICHTER",
  "source": null,
  "startedAt": 1773345217,
  "updatedAt": 1773426695,
  "endedAt": 1773453744
}
```

{% hint style="info" %}
Note: Coordinate arrays have been replaced with `[...]` for brevity. In actual API responses, these contain complete GeoJSON coordinate arrays. The `incident.properties` object has been truncated with `"..."` to show only key fields. The full response includes additional CAP metadata fields such as `note`, `references`, `rawMessage`, `eventCode`, and `headlineDescription`. The `features` collection includes EXPOSURE\_AREA features at different severity levels and a SMART\_ALERT feature; CAP\_INFO area features (one per alert zone) are also present in the full response but not shown here.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://api-v2-docs.disasteraware.com/hazards/hazard-samples/highwind-sample.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.