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

# Civil Unrest Sample

Civil unrest hazards cover protests, strikes, riots, and demonstrations detected from open-source reporting. The sample below is a `STRIKE` in Amritsar, Punjab, India. This is also the type that carries most port and airport disruptions: a dockworkers' or air-traffic strike is a `CIVILUNREST` / `STRIKE` event, with the affected infrastructure carried by the supply-chain fields rather than by the sub-type.

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.

**Sub-types** (`incident.properties.subType`): **`PROTEST`** (default), `STRIKE`, `RIOT`

## Type-Specific Properties

**Incident properties specific to civil unrest:** `participants`, `arrests` (mirrored from `n2h.quantitative`), plus the standard casualty fields `totalFatalities`, `totalWounded`, `civilianFatalities`, `civilianWounded` (null when not reported).

**Severity:** a peaceful protest or strike grades `ADVISORY` regardless of size; `RIOT`, injuries or arrests raise it to `WATCH`; deaths, ten or more injuries, or a riot with fifty or more arrests reach `WARNING`. The sample below carries a base tier of `WARNING` from its reported fatality and no cap.

**Quantitative counters (`n2h.quantitative`, mirrored into `incident.properties`):** `participants`, `arrests`, `deaths`, `injuries`; long-running unrest also carries `*_cumulative_since` counters.

## Sample Response

```json
{
  "name": [
    {
      "locale": "en",
      "value": "Government Employees' Strike — Punjab, India"
    }
  ],
  "description": [
    {
      "locale": "en",
      "value": "A Civil Unrest incident was reported in Punjab, India\non 2026-08-26.\n  Preliminary reports indicate 1 total victims comprised of 1 fatalities.\n\nEvent Summary*:\n• Civil Unrest has been reported in Punjab, India.\n• Reports indicate approximately 2000 participants.\n• 2 arrests reported.\n• Reports indicate that at least 1 people have been affected.\n• Affected areas include: Punjab, India.\n\nBased on 65 article(s) from: In... [truncated for brevity]"
    }
  ],
  "severity": "WARNING",
  "category": "EVENT",
  "type": "CIVILUNREST",
  "incident": {
    "uuid": "12a04acb-dfbd-4f88-9771-f05d257192ef",
    "type": "CIVILUNREST",
    "sourceId": 3000,
    "sourceRecordId": "CIVILUNREST-IND-PUNJAB-2026-08",
    "properties": {
      "totalFatalities": 1,
      "totalWounded": null,
      "civilianFatalities": 1,
      "civilianWounded": null,
      "type": "ACTUAL",
      "recordOrigin": "live",
      "incidentType": "Civil Unrest",
      "reportDate": "2026-08-26T10:30:03Z",
      "action": "NEW_EVENT",
      "incidentDuration": 4,
      "createdTime": "2026-08-26T10:30:03Z",
      "scopeOfIncident": "Local",
      "name": "Government Employees' Strike — Punjab, India",
      "status": "ACTIVE",
      "eventDate": "2026-08-26T00:00:00Z",
      "roles": "PUBLIC",
      "locationDescription": "Punjab, India",
      "Country_Name": "India",
      "Country_Code": "IN",
      "Country_Code_3": "IND",
      "provinceDistrictTown": "Punjab",
      "eventSummary": "Teachers in Punjab announced a complete boycott of non-academic work, demanding a focus on teaching duties. Additionally, Akali Dal leaders and workers staged a massive protest outside the Chief Engin... [truncated for brevity]",
      "sourceName": "India Today",
      "featureType": "INCIDENT",
      "bufferSize": 5000,
      "rawMessage": "[news article text truncated for brevity]",
      "subType": "STRIKE",
      "severityBasis": {
        "base": "WARNING"
      },
      "endedAtKind": "projected",
      "participants": 2000,
      "arrests": 2,
      "supplyChainImpact": true,
      "supplyChainInfrastructure": "HIGHWAY",
      "supplyChainDisruptionType": "BLOCKADE"
    }
  },
  "uuid": "12a04acb-dfbd-4f88-9771-f05d257192ef",
  "comment": null,
  "createdAt": 1787755604,
  "startedAt": 1787702400,
  "updatedAt": 1789557781,
  "endedAt": 1788048000,
  "latitude": 30.92932,
  "longitude": 75.50048,
  "version": 2,
  "creator": "News2Hazards (Automated)",
  "relatedHazards": [],
  "location": {
    "admin0": "India",
    "admin0_iso2": "IN",
    "admin0_iso3": "IND",
    "admin1": "Punjab",
    "admin1_code": "IN-PB",
    "continent": "Asia",
    "subregion": "Southern Asia",
    "location_type": "land",
    "source": "natural_earth_local"
  },
  "n2h": {
    "hazard_id": "CIVILUNREST-IND-PUNJAB-2026-08",
    "hazard_sub_type": "STRIKE",
    "summary": "Teachers in Punjab announced a complete boycott of non-academic work, demanding a focus on teaching duties. Additionally, Akali Dal leaders and workers staged a massive protest outside the Chief Engin... [truncated for brevity]",
    "is_ongoing": true,
    "start_date_iso": "2026-08-26",
    "end_date_iso": null,
    "location_level": "point",
    "location_specific": "Punjab",
    "country": "India",
    "article_count": 65,
    "quantitative": {
      "participants": 2000,
      "deaths": 1,
      "arrests": 2
    },
    "enhancedAt": 1789557781,
    "enhancer": "news2hazards@live",
    "sources": [
      {
        "name": "India Today",
        "title": "पेंशन, पे-स्केल, डीए... पंजाब में 7 लाख सरकारी कर्मचारी कल करेंगे हड़ताल",
        "url": "https://www.aajtak.in/india/punjab/story/punjab-government-employees-strike-old-pension-da-demand-ntc-bktw-rptc-2630472-2026-08-26?utm_source=rss",
        "type": "rss",
        "published_at": "2026-08-26T10:30:03+00:00",
        "body": "[article body truncated for brevity]"
      },
      {
        "name": "Times of India City",
        "title": "In Punjab, all govt OPDs, OOAT clinics to be closed on Aug 27 amid statewide employees' strike",
        "url": "https://timesofindia.indiatimes.com/city/chandigarh/in-punjab-all-govt-opds-ooat-clinics-to-be-closed-on-aug-27-amid-statewide-employees-strike/articleshow/133541433.cms",
        "type": "rss",
        "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": "Government Employees' Strike — Punjab, India",
          "casualties": {
            "killed": {
              "total": 1
            },
            "injured": {
              "total": 0
            }
          },
          "scopeOfIncident": "Local",
          "locationDescription": "Punjab, India"
        },
        "geometry": {
          "coordinates": [
            75.50048,
            30.92932
          ],
          "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 %}
