# Civil Unrest Sample

Civil unrest hazards including protests, riots, demonstrations, and social disturbances detected by AI for Humanity, PDC Global's generative AI and NLP technology. These hazards track significant civil unrest events worldwide, providing casualty data, severity scoring, and geographic context for each event.

## Civil Unrest-Specific Properties

### Incident Data

The `incident.properties` object for civil unrest hazards contains data from AI for Humanity. These properties describe the nature of the unrest, its casualties, severity, and geographic scope.

**Key incident properties for civil unrest hazards include:**

* `Incident_Type` - Type of incident (e.g., "Civil Unrest")
* `Total_Fatalities` / `Total_Wounded` - Total casualty counts
* `Civilian_Fatalities` / `Civilian_Wounded` - Civilian casualty counts
* `Police_Military_Fatalities` / `Police_Military_Wounded` - Security force casualty counts
* `Terrorist_Insurgent_Fatalities` / `Terrorist_Insurgent_Wounded` - Insurgent casualty counts
* `Incident_Score` - Overall incident severity score
* `Casualty_Weight` / `Scope_Weight` / `Incident_Type_Weight` / `Total_Weight` - Scoring components used to determine hazard priority
* `Incident_Severity` - Severity classification ("H" for high, "M" for medium, "L" for low)
* `Scope_of_Incident` - Geographic scope (e.g., "Local", "Township", "Regional")
* `Country_Name` / `Province_District_Town` - Location details
* `Event_Summary` - AI-generated summary of the incident
* `sourceName` / `Source` - News source that reported the event
* `sourceResourceLocations` - JSON array of source article URLs
* `casualties` - JSON string with killed/injured breakdown
* `bufferSize` - Buffer distance in meters for exposure geometry (e.g., 30000 for civil unrest)
* `rawMessage` - Full text of the source news article

### Features

Geopolitical hazards include features with `featureType` values of:

* **INCIDENT**: Point geometry at the incident location with casualty and event details
* **SMART\_ALERT**: Alert boundary polygon defining the hazard alert area

### Exposure Areas

Civil unrest hazards use 3 exposure levels based on distance buffers:

* **Level 1**: Moderate exposure (15-30km buffer)
* **Level 2**: Strong exposure (5-15km buffer)
* **Level 3**: Severe exposure (0-5km buffer)

The buffer size is determined by the `bufferSize` property in the incident (in meters). For civil unrest hazards, this is typically 30,000 meters (30km), reflecting the area that may be affected by protest activity and associated disruptions.

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Civil Unrest (Protest) - Mirpur Hindu, Uttar Pradesh, India"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "A Civil Unrest incident was reported in Mirpur Hindu, Uttar Pradesh, India on February 15, 2026.  Preliminary reports indicate 60 total victims comprised of 0 fatalities and 60 wounded.\n\nEvent Summary*:\n\u2022 Civil Unrest (Protest) has been reported in Mirpur Hindu, Uttar Pradesh, India.\n\u2022 Reports indicate that at least 60 people..."
    }
  ],
  "severity": "ADVISORY",
  "category": "EVENT",
  "incident": {
    "uuid": "75460855-c994-429b-a00d-e981f5ed73fb",
    "type": "CIVILUNREST",
    "sourceId": 2000,
    "sourceRecordId": "252f8213-f530-4f4b-8481-43250d7b5706",
    "properties": {
      "Terrorist_Insurgent_Fatalities": 0,
      "Total_Wounded": 60,
      "Civilian_Fatalities": 0,
      "type": "ACTUAL",
      "Incident_Type": "Civil Unrest",
      "reportDate": "2026-02-16T03:23:00Z",
      "Incident_Type_Weight": 2,
      "action": "NEW_EVENT",
      "Terrorist_Insurgent_Wounded": 0,
      "Incident_Duration": 1,
      "Created_Time": "2026-02-16T04:52:04Z",
      "casualties": "{\"killed\":{\"total\":0},\"injured\":{\"total\":60}}",
      "scopeOfIncident": "Local",
      "name": "Civil Unrest (Protest) - Mirpur Hindu, Uttar Pradesh, India",
      "Police_Military_Wounded": 0,
      "status": "NEW",
      "eventDate": "2026-02-15T15:00:00Z",
      "roles": "PUBLIC",
      "locationDescription": "Mirpur Hindu, Uttar Pradesh, India",
      "Incident_Score": 71.0,
      "sourceResourceLocations": "[...]",
      "Civilian_Wounded": 0,
      "Event_Summary": "\u2022 Civil Unrest (Protest) has been reported in Mirpur Hindu, Uttar Pradesh, India...",
      "Scope_Weight": 1,
      "rawMessage": "[news article text truncated for brevity]",
      "Source": "abplive.com",
      "Incident_Severity": "H",
      "featureType": "INCIDENT",
      "Casualty_Weight": 70.0,
      "event": "Civil Unrest",
      "Country_Name": "India",
      "Total_Weight": 142.0,
      "Province_District_Town": "Mirpur Hindu, Uttar Pradesh",
      "Total_Fatalities": 0,
      "Scope_of_Incident": "Local",
      "Police_Military_Fatalities": 0,
      "sourceName": "abplive.com",
      "bufferSize": 30000,
      "..."
    }
  },
  "uuid": "66e975a5-a4d4-4a31-8a43-f6205382c824",
  "comment": null,
  "createdAt": 1771217545,
  "relatedHazards": [],
  "longitude": 77.23477,
  "latitude": 28.8027,
  "version": 2,
  "alertGeometry": {
    "type": "FeatureCollection",
    "features": [
      {
        "type": "Feature",
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "properties": null
      }
    ]
  },
  "features": {
    "features": [
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "severity": "LIMITED",
          "featureType": "INCIDENT",
          "name": "Civil Unrest (Protest) - Mirpur Hindu, Uttar Pradesh, India",
          "casualties": {
            "killed": { "total": 0 },
            "injured": { "total": 60 }
          },
          "scopeOfIncident": "Local",
          "locationDescription": "Mirpur Hindu, Uttar Pradesh, India",
          "..."
        },
        "geometry": {
          "coordinates": [77.23477, 28.8027],
          "type": "Point"
        }
      },
      {
        "id": null,
        "type": "Feature",
        "properties": {
          "severity": "LIMITED",
          "featureType": "SMART_ALERT"
        },
        "geometry": {
          "coordinates": [...],
          "type": "Polygon"
        }
      }
    ],
    "type": "FeatureCollection"
  },
  "exposureAreas": {
    "features": [
      {
        "id": "1",
        "type": "Feature",
        "properties": {
          "exposureLevel": 1
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "sourceId": null
      },
      {
        "id": "2",
        "type": "Feature",
        "properties": {
          "exposureLevel": 2
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "sourceId": null
      },
      {
        "id": "3",
        "type": "Feature",
        "properties": {
          "exposureLevel": 3
        },
        "geometry": {
          "type": "Polygon",
          "coordinates": [...]
        },
        "sourceId": null
      }
    ],
    "type": "FeatureCollection"
  },
  "exposureAssessment": {
    "population": 17800000.0,
    "capital": 254269382000.0,
    "exposureLevels": [
      {
        "level": "1",
        "data": {
          "population": 12900000.0,
          "capital": 216694607200.0,
          "foodNeedsUnit": "CAL",
          "foodNeeds": 5922000000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 8460000.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 282000.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 9729000.0
        },
        "exposureDescription": "Moderate (15-30km)"
      },
      {
        "level": "2",
        "data": {
          "population": 4670000.0,
          "capital": 37468463500.0,
          "foodNeedsUnit": "CAL",
          "foodNeeds": 2142000000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 3060000.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 102000.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 3519000.0
        },
        "exposureDescription": "Strong (5-15km)"
      },
      {
        "level": "3",
        "data": {
          "population": 219000.0,
          "capital": 106311300.0,
          "foodNeedsUnit": "CAL",
          "foodNeeds": 100590000.0,
          "waterNeedsUnit": "liter",
          "waterNeeds": 143700.0,
          "wasteNeedsUnit": "100 liter",
          "wasteNeeds": 4790.0,
          "shelterNeedsUnit": "sq meters",
          "shelterNeeds": 165255.0
        },
        "exposureDescription": "Severe (0-5km)"
      }
    ],
    "hazardUuid": "",
    "hazardType": "",
    "version": "",
    "timestamp": "1771217533669",
    "exposureDescription": "",
    "foodNeedsUnit": "CAL",
    "foodNeeds": 8169000000.0,
    "waterNeedsUnit": "liter",
    "waterNeeds": 11670000.0,
    "wasteNeedsUnit": "100 liter",
    "wasteNeeds": 389000.0,
    "shelterNeedsUnit": "sq meters",
    "shelterNeeds": 13420500.0
  },
  "type": "CIVILUNREST",
  "creator": "RICHTER",
  "source": {
    "id": 2000,
    "name": "AI for Humanity",
    "longName": "AI for Humanity",
    "description": "TBD",
    "url": "https://www.pdc.org/artificial-intelligence/",
    "..."
  },
  "startedAt": 1771167600,
  "updatedAt": 1771217533,
  "endedAt": 1771340400
}
```

{% hint style="info" %}
Note: Coordinate arrays have been replaced with `[...]` for brevity. In actual API responses, these properties contain complete GeoJSON coordinate arrays. Additionally, `incident.properties`, `source`, and feature details have been truncated with `"..."` to show only key fields.
{% 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/civilunrest-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.