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

# Extreme Temperature Sample

Extreme temperature hazards including extreme heat and extreme cold events, sourced from national weather services (BoM, NWS, Environment Canada) via CAP alerts. These hazards represent official warnings about dangerous temperature conditions that pose risks to public health and safety.

## Extreme Temperature-Specific Properties

### Incident Data

The `incident.properties` object for extreme temperature hazards follows the CAP (Common Alerting Protocol) structure, containing metadata from the issuing weather service about the temperature event and its expected impact.

**Key incident properties for extreme temperature (CAP-based) include:**

* `senderName` - Name of the issuing authority (e.g., "NWS Tucson AZ and NWS Phoenix AZ")
* `headline` - Brief summary of the alert (e.g., "Extreme Heat Watch for South-Central and Southwest Arizona...")
* `description` - Detailed description of expected conditions
* `severity` - CAP severity level (e.g., "WATCH")
* `urgency` - CAP urgency classification (e.g., "Future")
* `certainty` - CAP certainty level (e.g., "Likely")
* `event` - Event type descriptor (e.g., "Extreme Heat")
* `effective` - ISO 8601 timestamp for when the alert takes effect
* `expires` - ISO 8601 timestamp for when the alert expires
* `category` - CAP category classification (e.g., "Met" for meteorological)

### Features

The `features` property is `null` for this extreme temperature hazard. When CAP alert features are available through the enrichment pipeline, the `features` FeatureCollection may contain:

* **CAP\_INFO** - MultiPolygon geometry representing the alert area, with properties mirroring the CAP alert fields including `severity`, `urgency`, `certainty`, `headline`, `description`, `senderName`, `effective`, `expires`, `area` (with `areaDesc` and `geocode`), and `featureType: "CAP_INFO"`
* **SMART\_ALERT** - MultiPolygon geometry representing the computed alert boundary with `featureType: "SMART_ALERT"`
* **EXPOSURE\_AREA** - MultiPolygon geometry for exposure assessment with `severity` (e.g., "STRONG") and `featureType: "EXPOSURE_AREA"`

### Exposure Areas

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

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Excessive Heat - Southwest Arizona & Southeast California, United States"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "NWS Tucson AZ and NWS Phoenix AZ has issued a Excessive Heat watch for March 18, 2026 18:00:00 UTC through March 23, 2026 03:00:00 UTC...."
    }
  ],
  "severity": "WATCH",
  "category": "EVENT",
  "incident": {
    "uuid": "188d8d91-f309-43fa-91dd-97e69254451b",
    "type": "EXTREMETEMPERATURE",
    "sourceId": 1801,
    "sourceRecordId": "9ed9bd39-704a-4ba3-a168-517c97685c40",
    "properties": {
      "senderName": "NWS Tucson AZ and NWS Phoenix AZ",
      "urgency": "Future",
      "id": "urn:oid:2.49.0.1.840.0.fa0ab7ac06584aa567d945d616152173e78fb62b.001.1",
      "headline": "Extreme Heat Watch for South-Central and Southwest Arizona (including Phoenix Metro) and Southeast California through March 22",
      "severity": "WATCH",
      "certainty": "Likely",
      "status": "Actual",
      "...": ""
    }
  },
  "uuid": "f353c464-3cad-4fb9-9d3f-77fad3c5e1c0",
  "comment": null,
  "createdAt": 1773430392,
  "relatedHazards": [],
  "longitude": -111.42524,
  "latitude": 32.42098,
  "version": 3,
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "properties": null
      }
    ]
  },
  "features": null,
  "exposureAreas": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "MultiPolygon",
          "coordinates": [...]
        },
        "properties": {
          "exposureLevel": 2
        }
      }
    ]
  },
  "exposureAssessment": {
    "population": {
      "total": 7090018,
      "total0_14": 1247845,
      "total15_64": 4605676,
      "households": 2847394,
      "vulnerable": 850007,
      "total65_Plus": 1235788
    },
    "capital": {
      "total": 797777412400,
      "school": 2657,
      "hospital": 114
    },
    "totalByCountry": [
      {
        "population": {
          "total": 18,
          "total0_14": 5,
          "total15_64": 12,
          "households": 5,
          "vulnerable": 7,
          "total65_Plus": 1
        },
        "country": "MEX",
        "capital": {
          "total": 0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Mexico",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 13944.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 19.92,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.664,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 22.908
      },
      {
        "population": {
          "total": 7090000,
          "total0_14": 1247840,
          "total15_64": 4605664,
          "households": 2847390,
          "vulnerable": 850000,
          "total65_Plus": 1235787
        },
        "country": "USA",
        "capital": {
          "total": 797777412400,
          "school": 2657,
          "hospital": 114
        },
        "admin0": "United States",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "MRE",
        "foodNeeds": 1700000.0,
        "waterNeedsUnit": "gal",
        "waterNeeds": 673625.0,
        "wasteNeedsUnit": "25 gal",
        "wasteNeeds": 85000.0,
        "shelterNeedsUnit": "sq feet",
        "shelterNeeds": 9758000.0
      }
    ],
    "totalByAdmin": [
      {
        "population": {
          "total": 18,
          "total0_14": 5,
          "total15_64": 12,
          "households": 5,
          "vulnerable": 7,
          "total65_Plus": 1
        },
        "country": "MEX",
        "capital": {
          "total": 0,
          "school": 0,
          "hospital": 0
        },
        "admin0": "Mexico",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 13944.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 19.92,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 0.664,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 22.908
      },
      {
        "population": {
          "total": 7090000,
          "total0_14": 1247840,
          "total15_64": 4605664,
          "households": 2847390,
          "vulnerable": 850000,
          "total65_Plus": 1235787
        },
        "country": "USA",
        "capital": {
          "total": 797777412400,
          "school": 2657,
          "hospital": 114
        },
        "admin0": "United States",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "MRE",
        "foodNeeds": 1700000.0,
        "waterNeedsUnit": "gal",
        "waterNeeds": 673625.0,
        "wasteNeedsUnit": "25 gal",
        "wasteNeeds": 85000.0,
        "shelterNeedsUnit": "sq feet",
        "shelterNeeds": 9758000.0
      }
    ],
    "exposureLevels": [
      {
        "level": "2",
        "data": {
          "population": {
            "total": 7090018,
            "total0_14": 1247845,
            "total15_64": 4605676,
            "households": 2847394,
            "vulnerable": 850007,
            "total65_Plus": 1235788
          },
          "capital": {
            "total": 797777412400,
            "school": 2657,
            "hospital": 114
          },
          "totalByCountry": [
            {
              "population": {
                "total": 18,
                "total0_14": 5,
                "total15_64": 12,
                "households": 5,
                "vulnerable": 7,
                "total65_Plus": 1
              },
              "country": "MEX",
              "capital": {
                "total": 0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Mexico",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 13944.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 19.92,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.664,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 22.908
            },
            {
              "population": {
                "total": 7090000,
                "total0_14": 1247840,
                "total15_64": 4605664,
                "households": 2847390,
                "vulnerable": 850000,
                "total65_Plus": 1235787
              },
              "country": "USA",
              "capital": {
                "total": 797777412400,
                "school": 2657,
                "hospital": 114
              },
              "admin0": "United States",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "MRE",
              "foodNeeds": 1700000.0,
              "waterNeedsUnit": "gal",
              "waterNeeds": 673625.0,
              "wasteNeedsUnit": "25 gal",
              "wasteNeeds": 85000.0,
              "shelterNeedsUnit": "sq feet",
              "shelterNeeds": 9758000.0
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 18,
                "total0_14": 5,
                "total15_64": 12,
                "households": 5,
                "vulnerable": 7,
                "total65_Plus": 1
              },
              "country": "MEX",
              "capital": {
                "total": 0,
                "school": 0,
                "hospital": 0
              },
              "admin0": "Mexico",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 13944.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 19.92,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 0.664,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 22.908
            },
            {
              "population": {
                "total": 7090000,
                "total0_14": 1247840,
                "total15_64": 4605664,
                "households": 2847390,
                "vulnerable": 850000,
                "total65_Plus": 1235787
              },
              "country": "USA",
              "capital": {
                "total": 797777412400,
                "school": 2657,
                "hospital": 114
              },
              "admin0": "United States",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "MRE",
              "foodNeeds": 1700000.0,
              "waterNeedsUnit": "gal",
              "waterNeeds": 673625.0,
              "wasteNeedsUnit": "25 gal",
              "wasteNeeds": 85000.0,
              "shelterNeedsUnit": "sq feet",
              "shelterNeeds": 9758000.0
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 1785000000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 2550000.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 85000.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 2932500.0
        },
        "exposureDescription": "STRONG"
      }
    ],
    "hazardUuid": "",
    "hazardType": "",
    "version": "",
    "timestamp": "1773430370086",
    "exposureDescription": "",
    "foodNeedsUnit": "CAL",
    "foodNeeds": 1785000000.0,
    "waterNeedsUnit": "liter",
    "waterNeeds": 2550000.0,
    "wasteNeedsUnit": "100 liter",
    "wasteNeeds": 85000.0,
    "shelterNeedsUnit": "sq meters",
    "shelterNeeds": 2932500.0
  },
  "type": "EXTREMETEMPERATURE",
  "creator": "RICHTER",
  "source": null,
  "startedAt": 1773943200,
  "updatedAt": 1773430368,
  "endedAt": 1774234800
}
```

{% 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 `features` property is `null` for this hazard. The `source` field is `null` for NWS extreme temperature hazards. Population values within `exposureAssessment` are integers; `capital.school` and `capital.hospital` are counts of exposed facilities.
{% endhint %}