> 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/osint-hazards/requesting-osint-hazards/flood-sample.md).

# Flood Sample

Flood hazards cover flood events reported in open sources. They complement the model-driven flood hazards on `/active-hazards-query`, capturing local flooding that is reported in the press but not always reflected in global flood models. The sample below is flooding in Bulacan, Philippines.

These hazards are returned by the [`/osint-hazards-query`](https://api-v2-docs.disasteraware.com/osint-hazards/requesting-osint-hazards.md) endpoint, which requires a specific role on your credentials.

## Type-Specific Properties

**Flood is the only OSINT type with no sub-type vocabulary.** `incident.properties.subType` is **omitted** on flood records (the internal `n2h.hazard_sub_type` mirror is an empty string), so filtering floods with `sub_type` returns nothing.

**Incident properties specific to floods** are mirrored 1:1 from `n2h.quantitative` and keep their snake\_case names: `flood_depth_ft`, `homes_flooded`, `roads_closed`, `rescues`, `evacuees`, `damage_estimate_usd`, `deaths`, `injuries`, `missing`. Floods that close roads or rail also carry the supply-chain fields (`supplyChainImpact`, `supplyChainInfrastructure`, `supplyChainDisruptionType`).

**Severity:** deaths, 100 or more evacuees or flooded homes, or damage of $10M or more grade `WARNING`; injuries, rescues, any evacuees or flooded homes, depth of two feet or more, or three or more road closures grade `WATCH`; street ponding and single closures grade `ADVISORY`.

**Quantitative counters (`n2h.quantitative`, mirrored into `incident.properties`):** `flood_depth_ft`, `homes_flooded`, `roads_closed`, `rescues`, `evacuees`, `damage_estimate_usd`, `deaths`, `injuries`, `missing`.

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Persistent Flooding — Calumpit, Bulacan, Philippines"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "A Flood incident was reported in Barasoain Church, Philippines\non 2026-08-26.\n  Preliminary reports indicate 24 total victims comprised of 5 fatalities and 19 wounded.\n\nEvent Summary*:\n• Flood has been reported in Barasoain Church, Philippines.\n• 1 rescues reported.\n• 12237 evacuees.\n• Flood depth: 6 ft.\n• Estimated damage: $4380.0M.\n• Reports indicate that at least 24 people have been affected.\n• Affected areas incl... [truncated for brevity]"
    }
  ],
  "severity": "WARNING",
  "category": "EVENT",
  "type": "FLOOD",
  "incident": {
    "uuid": "aab00d42-ce04-43fc-b0a9-026c13baaa0d",
    "type": "FLOOD",
    "sourceId": 3000,
    "sourceRecordId": "FLOOD-PHI-CALUMPIT-BULACAN-2026-08",
    "properties": {
      "totalFatalities": 5,
      "totalWounded": 19,
      "civilianFatalities": 5,
      "civilianWounded": 19,
      "type": "ACTUAL",
      "recordOrigin": "live",
      "incidentType": "Flood",
      "reportDate": "2026-08-28T16:05:00Z",
      "action": "NEW_EVENT",
      "incidentDuration": 4,
      "createdTime": "2026-08-28T16:05:00Z",
      "scopeOfIncident": "Local",
      "name": "Persistent Flooding — Calumpit, Bulacan, Philippines",
      "status": "ACTIVE",
      "eventDate": "2026-08-26T00:00:00Z",
      "roles": "PUBLIC",
      "locationDescription": "Barasoain Church, Philippines",
      "Country_Name": "Philippines",
      "Country_Code": "PH",
      "Country_Code_3": "PHL",
      "provinceDistrictTown": "Barasoain Church",
      "eventSummary": "Flooding and lahar concerns have prompted dredging efforts on the Gugu River in Minalin.",
      "sourceName": "gmanetwork.com",
      "featureType": "INCIDENT",
      "bufferSize": 5000,
      "rawMessage": "[news article text truncated for brevity]",
      "severityBasis": {
        "base": "WARNING"
      },
      "endedAtKind": "projected",
      "supplyChainImpact": true,
      "supplyChainInfrastructure": "HIGHWAY",
      "supplyChainDisruptionType": "CLOSURE",
      "flood_depth_ft": 6,
      "rescues": 1,
      "evacuees": 12237,
      "homes_flooded": 3584,
      "roads_closed": 3,
      "damage_estimate_usd": 4380000000
    }
  },
  "uuid": "aab00d42-ce04-43fc-b0a9-026c13baaa0d",
  "comment": null,
  "createdAt": 1787935197,
  "startedAt": 1787702400,
  "updatedAt": 1789577911,
  "endedAt": 1788048000,
  "latitude": 14.84637,
  "longitude": 120.81232,
  "version": 2,
  "creator": "News2Hazards (Automated)",
  "relatedHazards": [],
  "location": {
    "admin0": "Philippines",
    "admin0_iso2": "PH",
    "admin0_iso3": "PHL",
    "admin1": "Bulacan",
    "admin1_code": "PH-BUL",
    "continent": "Asia",
    "subregion": "South-Eastern Asia",
    "location_type": "land",
    "source": "natural_earth_local"
  },
  "n2h": {
    "hazard_id": "FLOOD-PHI-CALUMPIT-BULACAN-2026-08",
    "hazard_sub_type": "",
    "summary": "Flooding and lahar concerns have prompted dredging efforts on the Gugu River in Minalin.",
    "is_ongoing": true,
    "start_date_iso": "2026-08-26",
    "end_date_iso": null,
    "location_level": "point",
    "location_specific": "Barasoain Church",
    "country": "Philippines",
    "article_count": 102,
    "quantitative": {
      "homes_flooded": 3584,
      "evacuees": 12237,
      "area_under_water_acres": 81000,
      "homes_destroyed": 1,
      "flood_depth_ft": 6,
      "rescues": 1,
      "deaths": 5,
      "deaths_cumulative_since": 34,
      "traffic_speed_kph": 1,
      "damage_estimate_usd": 4380000000,
      "people_stranded": 99000,
      "power_outages": 6,
      "flood_duration_hours": 720,
      "roads_closed": 3,
      "injuries": 19,
      "affected_area_sqmi": 6175,
      "vehicles_stranded": 1,
      "river_stage_ft": 20.67
    },
    "enhancedAt": 1789577911,
    "enhancer": "news2hazards@live",
    "sources": [
      {
        "name": "gmanetwork.com",
        "title": "Calumpit, Bulacan remains flooded; over 1,300 families evacuated | GMA News Online",
        "url": "https://www.gmanetwork.com/news/topstories/regions/1000287/calumpit-bulacan-remains-flooded-over-1-300-families-evacuated/story/",
        "type": "kafka_webz",
        "published_at": "2026-08-28T16:05:00+00:00",
        "body": "[article body truncated for brevity]"
      },
      {
        "name": "philnews.ph",
        "title": "House in Lubao, Pampanga Collapses & Swept Away by Strong Floodwaters | PhilNews",
        "url": "https://philnews.ph/2026/08/29/house-lubao-pampanga-collapses-swept-away-strong-floodwaters/",
        "type": "kafka_webz",
        "published_at": null,
        "body": "[article body truncated for brevity]"
      },
      "..."
    ],
    "location_details": {
      "..."
    },
    "extra": {
      "..."
    }
  },
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "properties": null
      }
    ]
  },
  "features": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "properties": {
          "severity": "WARNING",
          "featureType": "INCIDENT",
          "name": "Persistent Flooding — Calumpit, Bulacan, Philippines",
          "casualties": {
            "killed": {
              "total": 5
            },
            "injured": {
              "total": 19
            }
          },
          "scopeOfIncident": "Local",
          "locationDescription": "Barasoain Church, Philippines"
        },
        "geometry": {
          "coordinates": [
            120.81232,
            14.84637
          ],
          "type": "Point"
        }
      },
      {
        "type": "Feature",
        "properties": {
          "severity": "WARNING",
          "featureType": "SMART_ALERT"
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        }
      }
    ]
  },
  "exposureAreas": null,
  "exposureAssessment": null,
  "source": {
    "id": 3000,
    "name": "News2Hazards",
    "longName": "News2Hazards Automated Pipeline",
    "description": "Automated hazard detection from news article analysis"
  }
}
```

{% hint style="info" %}
Note: Coordinate arrays have been replaced with `[...]` for brevity. In actual API responses, these properties contain complete GeoJSON coordinate arrays. The `n2h.sources` array and the `features` properties have been truncated with `"..."` to show only key fields, and article text has been elided. `n2h.extra` and `n2h.location_details` are reserved for internal use. The record shows the post-cutover shape of September 2026; see [Requesting OSINT Hazards](https://api-v2-docs.disasteraware.com/osint-hazards/requesting-osint-hazards.md) for how pre-cutover records differ.
{% endhint %}
