> 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 severe waterlogging across Delhi-NCR, India, corroborated across 50 articles.

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

{% hint style="warning" %}
**Flood is the only OSINT type with no sub-type system.** `hazard_sub_type` is always an empty string (`""`) on a flood hazard, so filtering floods with the `sub_type` parameter returns nothing. Every other type is guaranteed to carry a non-empty sub-type.
{% endhint %}

## Type-Specific Properties

**Incident properties specific to floods:**

* `rainfall_inches` — reported rainfall
* `flood_depth_ft` — reported flood depth
* `homes_flooded` — homes reported flooded
* `roads_closed` — roads reported closed
* `rescues` — rescues reported

Because floods frequently close roads and rail, this type commonly carries the supply-chain fields. In the sample below, a national highway was flooded, so the hazard is returned by `supply_chain=true` with `SupplyChainInfrastructure: HIGHWAY` and `SupplyChainDisruptionType: CLOSURE`.

**Quantitative counters (`n2h.quantitative`):**

`rainfall_inches`, `flood_depth_ft`, `homes_flooded`, `roads_closed`, `schools_closed`, `power_outages`, `vehicles_stranded`, `rescues`, `deaths`, `injuries`.

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Severe Waterlogging and Traffic Disruptions — Delhi-ncr, India"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "A Flood incident was reported in Sadar Bazar, India\non 2026-07-07.\n  Preliminary reports indicate 2 total victims comprised of 1 fatalities and 1 wounded.\n\nEvent Summary*:\n• Flood has been reported in Sadar Bazar, India.\n• 1 rescues reported.\n• Flood depth: 1.5 ft.\n• Reports indicate that at least 2 people have been affected.\n• Affected areas include: Sadar Bazar, India.\n\nBased on 50 article(s) from: abplive.com, mon... [truncated for brevity]"
    }
  ],
  "severity": "WARNING",
  "category": "EVENT",
  "type": "FLOOD",
  "hazard_sub_type": "",
  "incident": {
    "uuid": "8f095756-7064-49d6-9110-46afbddae9da",
    "type": "FLOOD",
    "sourceId": 3000,
    "sourceRecordId": "FLOOD-IND-DELHI-NCR-2026-07",
    "properties": {
      "Total_Fatalities": 1,
      "Total_Wounded": 1,
      "Civilian_Fatalities": 1,
      "Civilian_Wounded": 1,
      "Police_Military_Fatalities": 0,
      "Police_Military_Wounded": 0,
      "Terrorist_Insurgent_Fatalities": 0,
      "Terrorist_Insurgent_Wounded": 0,
      "type": "ACTUAL",
      "Incident_Type": "Flood",
      "reportDate": "2026-07-09T06:46:00+00:00",
      "action": "NEW_EVENT",
      "Incident_Duration": 4,
      "Created_Time": "2026-07-09T06:46:00+00:00",
      "casualties": "{\"killed\": {\"total\": 1}, \"injured\": {\"total\": 1}}",
      "scopeOfIncident": "Local",
      "name": "Severe Waterlogging and Traffic Disruptions — Delhi-ncr, India",
      "status": "ACTIVE",
      "eventDate": "2026-07-07T00:00:00Z",
      "roles": "PUBLIC",
      "locationDescription": "Sadar Bazar, India",
      "Country_Name": "India",
      "Country_Code": "IN",
      "Country_Code_3": "IND",
      "Province_District_Town": "Sadar Bazar",
      "Event_Summary": "An engineer collapsed near an electric pole and fell into an open drain along a flooded road in Noida, possibly due to electrocution.",
      "Source": "abplive.com",
      "sourceName": "abplive.com",
      "event": "Flood",
      "featureType": "INCIDENT",
      "bufferSize": 5000,
      "rawMessage": "[news article text truncated for brevity]",
      "Scope_of_Incident": "Local",
      "Incident_Severity": "H",
      "SupplyChainImpact": true,
      "SupplyChainInfrastructure": "HIGHWAY",
      "SupplyChainDisruptionType": "CLOSURE",
      "flood_depth_ft": 1.5,
      "rainfall_inches": 100,
      "rescues": 1,
      "homes_flooded": 68,
      "roads_closed": 10,
      "..."
    }
  },
  "uuid": "8f095756-7064-49d6-9110-46afbddae9da",
  "comment": null,
  "createdAt": 1783663050,
  "startedAt": 1783382400,
  "updatedAt": 1783878757,
  "endedAt": 1783728000,
  "latitude": 28.658087,
  "longitude": 77.2170087,
  "version": 2,
  "creator": "News2Hazards (Automated)",
  "relatedHazards": [],
  "locationDetails": {
    "version": 2,
    "country": "India",
    "country_code": "IN",
    "country_code_3": "IND",
    "continent": "Asia",
    "subregion": "Southern Asia",
    "state_province": "Delhi",
    "state_code": "IN-DL",
    "location_type": "land"
  },
  "n2h": {
    "hazard_id": "FLOOD-IND-DELHI-NCR-2026-07",
    "hazard_sub_type": "",
    "summary": "An engineer collapsed near an electric pole and fell into an open drain along a flooded road in Noida, possibly due to electrocution.",
    "is_ongoing": true,
    "start_date_iso": "2026-07-07",
    "end_date_iso": null,
    "location_level": "point",
    "location_specific": "Sadar Bazar",
    "country": "India",
    "article_count": 50,
    "quantitative": {
      "rainfall_inches": 100,
      "roads_closed": 10,
      "schools_closed": 1,
      "vehicles_stranded": 1,
      "homes_flooded": 68,
      "deaths": 1,
      "flood_depth_ft": 1.5,
      "power_outages": 26,
      "injuries": 1,
      "rescues": 1
    },
    "sources": [
      {
        "name": "abplive.com",
        "title": "Delhi On Red Alert For Extremely Heavy Rain In Next Few Hours; Waterlogging Disrupts Traffic Across NCR",
        "url": "https://news.abplive.com/cities/delhi-ncr-rain-red-alert-as-imd-warns-of-extremely-heavy-rain-waterlogging-disrupts-traffic-across-ncr-1855401",
        "type": "kafka_webz",
        "published_at": "2026-07-09T06:46:00+00:00",
        "body": "[article body truncated for brevity]"
      },
      {
        "name": "moneycontrol.com",
        "title": "Delhi on red alert: Heavy rain floods roads, triggers massive traffic chaos across NCR | Videos",
        "url": "https://www.moneycontrol.com/city/delhi-on-red-alert-heavy-rain-floods-noida-gurugram-ghaziabad-rain-imd-delhi-article-13969715.html",
        "type": "kafka_webz",
        "published_at": null,
        "body": "[article body truncated for brevity]"
      },
      "..."
    ],
    "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": "Severe Waterlogging and Traffic Disruptions — Delhi-ncr, India",
          "casualties": {
            "killed": {
              "total": 1
            },
            "injured": {
              "total": 1
            }
          },
          "scopeOfIncident": "Local",
          "locationDescription": "Sadar Bazar, India"
        },
        "geometry": {
          "coordinates": [
            77.2170087,
            28.658087
          ],
          "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 `incident.properties` and `features` objects have been truncated with `"..."` to show only key fields, and article text has been elided. The `n2h.extra` object is reserved for internal use.
{% endhint %}
