# Flood Sample

This page provides a complete sample response for a flood hazard from the Active Hazards API endpoint. Flood hazards are sourced from multiple providers including the NASA Global Flood Model and the Australian Bureau of Meteorology. The sample below shows an Australian BoM riverine flood warning.

## Flood-Specific Properties

### Incident Data

The `incident.properties` object for flood hazards varies by source. For Australian Bureau of Meteorology alerts, key properties include:

* `hazardName` - Name of the flood event
* `senderName` - Source name (e.g., "Australian Government Bureau of Meteorology")
* `headline` - Official flood warning headline text
* `severity` - Severity level (e.g., "Severe")
* `urgency` - Urgency classification
* `certainty` - Certainty classification

For NASA Global Flood Model alerts, additional properties include `pfafId`, `pfafIdList`, `rfrScore`, `cfrScore`, `scaledRiverineRisk`, `scaledCoastalRisk`, `hazardScore`, `GloFAS2Yr`/`GloFAS5Yr`/`GloFAS20Yr`, `VIIRSTotalScore`, `DFOTotalScore`, `oneDayFloodAreaKm`/`fiveDayFloodAreaKm`, `incidentSeverity`, and `flag`.

### Features

The `features` property for floods contains GeoJSON features describing the affected areas. Feature types and content vary by source provider.

### Exposure Areas

Floods may use multiple exposure levels depending on the source:

* **Level 0 (LIMITED)**: Areas with limited flood exposure
* **Level 1 (MODERATE)**: Areas with moderate flood exposure
* **Level 2 (STRONG)**: Areas with strong flood exposure

### Exposure Assessment Units

* **`population`**: Object containing demographic breakdowns — `total` (number of people), `total0_14` (children 0-14), `total15_64` (adults 15-64), `total65_Plus` (seniors 65+), `households` (number of households), `vulnerable` (vulnerable population)
* **`capital`**: Object containing infrastructure data — `total` (USD replacement value), `school` (number of schools), `hospital` (number of hospitals)
* **`totalByCountry`**: Array of regional breakdowns per country, each containing `population`, `capital`, country code (`country`), admin names (`admin0`, `admin1`, `admin2`), and humanitarian needs (`foodNeeds`, `waterNeeds`, `wasteNeeds`, `shelterNeeds` with units)
* **`totalByAdmin`**: Array of admin-level breakdowns with the same structure as `totalByCountry`
* **Humanitarian needs**: `foodNeeds` (CAL), `waterNeeds` (liters), `wasteNeeds` (100 liters), `shelterNeeds` (sq meters)

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Riverine Flood - Rockhampton, Queensland, Australia"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "Australian Government Bureau of Meteorology has issued a Riverine Flood Warning for March 13, 2026, 05:17:18 UTC through March 14, 2026, 05:17:36 UTC for Rockhampton, Queensland, Australia.\n\nIt is estimated that 147,000 people, 59,000 households, and $20.7 Billion (USD) of infrastructure* are within the affected area(s). ..."
    }
  ],
  "severity": "WARNING",
  "category": "EVENT",
  "incident": {
    "uuid": "169dde41-c987-4765-a8ef-7e717a9bb9b4",
    "type": "FLOOD",
    "sourceId": 1799,
    "sourceRecordId": "AusBoM-IDQ20765-2026-03-08T04:53:36+00:00",
    "properties": {
      "hazardName": "Riverine Flood - Rockhampton, Queensland, Australia",
      "senderName": "Australian Government Bureau of Meteorology",
      "urgency": "Unknown",
      "headline": "Moderate Flood Warning for Dawson River to Theodore...",
      "severity": "Severe",
      "certainty": "Unknown",
      "status": null,
      "...": ""
    }
  },
  "uuid": "9f7cbaef-6cb0-47f7-99d7-eb59632434d8",
  "comment": null,
  "createdAt": 1773379056,
  "relatedHazards": [],
  "longitude": 149.04417,
  "latitude": -24.64846,
  "version": 19,
  "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": {
          "coordinates": [...],
          "type": "Polygon",
          "properties": {
            "type": "EXPOSURE_AREA",
            "featureType": "EXPOSURE_AREA",
            "severity": "LIMITED"
          }
        },
        "incidentType": null,
        "sourceId": null
      },
      "..."
    ],
    "incidentType": null,
    "metadata": null,
    "type": "FeatureCollection",
    "sourceId": null
  },
  "exposureAreas": {
    "features": [
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "exposureLevel": 0
        },
        "geometry": {
          "coordinates": [...],
          "type": "Polygon",
          "properties": {
            "type": "EXPOSURE_AREA",
            "featureType": "EXPOSURE_AREA",
            "severity": "LIMITED"
          }
        },
        "sourceId": null
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "exposureLevel": 1
        },
        "geometry": {
          "coordinates": [...],
          "type": "MultiPolygon",
          "properties": {
            "type": "EXPOSURE_AREA",
            "featureType": "EXPOSURE_AREA",
            "severity": "MODERATE"
          }
        },
        "sourceId": null
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "exposureLevel": 2
        },
        "geometry": {
          "coordinates": [...],
          "type": "Polygon",
          "properties": {
            "type": "EXPOSURE_AREA",
            "featureType": "EXPOSURE_AREA",
            "severity": "STRONG"
          }
        },
        "sourceId": null
      }
    ],
    "type": "FeatureCollection"
  },
  "exposureAssessment": {
    "population": {
      "total": 147000,
      "total0_14": 26504,
      "total15_64": 94962,
      "total65_Plus": 25563,
      "households": 59036,
      "vulnerable": 19100
    },
    "capital": {
      "total": 20710059300,
      "school": 4,
      "hospital": 13
    },
    "totalByCountry": [
      {
        "population": {
          "total": 147000,
          "total0_14": 26504,
          "total15_64": 94962,
          "total65_Plus": 25563,
          "households": 59036,
          "vulnerable": 19100
        },
        "country": "AUS",
        "capital": {
          "total": 20710059300,
          "school": 4,
          "hospital": 13
        },
        "admin0": "Australia",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 40110000.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 57300.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 1910.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 65895.0
      }
    ],
    "totalByAdmin": [
      {
        "population": {
          "total": 147000,
          "total0_14": 26504,
          "total15_64": 94962,
          "total65_Plus": 25563,
          "households": 59036,
          "vulnerable": 19100
        },
        "country": "AUS",
        "capital": {
          "total": 20710059300,
          "school": 4,
          "hospital": 13
        },
        "admin0": "Australia",
        "admin1": null,
        "admin2": null,
        "foodNeedsUnit": "CAL",
        "foodNeeds": 40110000.0,
        "waterNeedsUnit": "liter",
        "waterNeeds": 57300.0,
        "wasteNeedsUnit": "100 liter",
        "wasteNeeds": 1910.0,
        "shelterNeedsUnit": "sq meters",
        "shelterNeeds": 65895.0
      }
    ],
    "exposureLevels": [
      {
        "level": "0",
        "data": {
          "population": {
            "total": 39500,
            "total0_14": 7122,
            "total15_64": 25517,
            "total65_Plus": 6869,
            "households": 15863,
            "vulnerable": 5130
          },
          "capital": {
            "total": 3638989100,
            "school": 1,
            "hospital": 4
          },
          "totalByCountry": [
            {
              "population": {
                "total": 39500,
                "total0_14": 7122,
                "total15_64": 25517,
                "total65_Plus": 6869,
                "households": 15863,
                "vulnerable": 5130
              },
              "country": "AUS",
              "capital": {
                "total": 3638989100,
                "school": 1,
                "hospital": 4
              },
              "admin0": "Australia",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 10773000.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 15390.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 513.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 17698.5
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 39500,
                "total0_14": 7122,
                "total15_64": 25517,
                "total65_Plus": 6869,
                "households": 15863,
                "vulnerable": 5130
              },
              "country": "AUS",
              "capital": {
                "total": 3638989100,
                "school": 1,
                "hospital": 4
              },
              "admin0": "Australia",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 10773000.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 15390.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 513.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 17698.5
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 10773000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 15390.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 513.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 17698.5
        },
        "exposureDescription": "LIMITED"
      },
      {
        "level": "1",
        "data": {
          "population": {
            "total": 102000,
            "total0_14": 18391,
            "total15_64": 65892,
            "total65_Plus": 17738,
            "households": 40964,
            "vulnerable": 13200
          },
          "capital": {
            "total": 16397037900,
            "school": 3,
            "hospital": 7
          },
          "totalByCountry": [
            {
              "population": {
                "total": 102000,
                "total0_14": 18391,
                "total15_64": 65892,
                "total65_Plus": 17738,
                "households": 40964,
                "vulnerable": 13200
              },
              "country": "AUS",
              "capital": {
                "total": 16397037900,
                "school": 3,
                "hospital": 7
              },
              "admin0": "Australia",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 27720000.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 39600.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 1320.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 45540.0
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 102000,
                "total0_14": 18391,
                "total15_64": 65892,
                "total65_Plus": 17738,
                "households": 40964,
                "vulnerable": 13200
              },
              "country": "AUS",
              "capital": {
                "total": 16397037900,
                "school": 3,
                "hospital": 7
              },
              "admin0": "Australia",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 27720000.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 39600.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 1320.0,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 45540.0
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 27720000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 39600.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 1320.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 45540.0
        },
        "exposureDescription": "MODERATE"
      },
      {
        "level": "2",
        "data": {
          "population": {
            "total": 5790,
            "total0_14": 1044,
            "total15_64": 3740,
            "total65_Plus": 1007,
            "households": 2325,
            "vulnerable": 752
          },
          "capital": {
            "total": 674032300,
            "school": 0,
            "hospital": 2
          },
          "totalByCountry": [
            {
              "population": {
                "total": 5790,
                "total0_14": 1044,
                "total15_64": 3740,
                "total65_Plus": 1007,
                "households": 2325,
                "vulnerable": 752
              },
              "country": "AUS",
              "capital": {
                "total": 674032300,
                "school": 0,
                "hospital": 2
              },
              "admin0": "Australia",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 1579200.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 2256.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 75.2,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 2594.4
            }
          ],
          "totalByAdmin": [
            {
              "population": {
                "total": 5790,
                "total0_14": 1044,
                "total15_64": 3740,
                "total65_Plus": 1007,
                "households": 2325,
                "vulnerable": 752
              },
              "country": "AUS",
              "capital": {
                "total": 674032300,
                "school": 0,
                "hospital": 2
              },
              "admin0": "Australia",
              "admin1": null,
              "admin2": null,
              "foodNeedsUnit": "CAL",
              "foodNeeds": 1579200.0,
              "waterNeedsUnit": "liter",
              "waterNeeds": 2256.0,
              "wasteNeedsUnit": "100 liter",
              "wasteNeeds": 75.2,
              "shelterNeedsUnit": "sq meters",
              "shelterNeeds": 2594.4
            }
          ],
          "foodNeedsUnit": "CAL",
          "foodNeeds": 1579200.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 2256.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 75.2,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 2594.4
        },
        "exposureDescription": "STRONG"
      }
    ],
    "hazardUuid": "",
    "hazardType": "",
    "version": "",
    "timestamp": "1773379040778",
    "exposureDescription": "",
    "foodNeedsUnit": "CAL",
    "foodNeeds": 40110000.0,
    "waterNeedsUnit": "liter",
    "waterNeeds": 57300.0,
    "wasteNeedsUnit": "100 liter",
    "wasteNeeds": 1910.0,
    "shelterNeedsUnit": "sq meters",
    "shelterNeeds": 65895.0
  },
  "type": "FLOOD",
  "creator": "RICHTER",
  "source": null,
  "startedAt": 1772946151,
  "updatedAt": 1773379040,
  "endedAt": 1773465456
}
```

{% hint style="info" %}
Note: Coordinate arrays have been replaced with `[...]` for brevity. The `features` array has been truncated to show a representative EXPOSURE\_AREA feature type. This sample contained 3 exposure area features (LIMITED, MODERATE, STRONG) with 3 corresponding exposure levels in the exposure assessment.
{% 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/flood-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.