For the complete documentation index, see llms.txt. This page is also available as Markdown.
Man-made Sample
This page provides a complete sample response for a man-made hazard from the Active Hazards API endpoint. The MANMADE type covers human-caused or human-driven crises that are not classified under the geopolitical types (COMBAT, TERRORISM, CIVILUNREST, ACCIDENT) — the sample below is a famine. These hazards are curated by PDC analysts and entered manually, so the record uses the generic PDC incident envelope.
Man-made-Specific Properties
Incident Data
This hazard uses the generic PDC incident envelope in incident.properties — the common shape shared by all PDC-curated and manually entered hazards, regardless of type.
glideUri / charterUri / sncUrl - External references, when assigned
overrideDescription / overrideStartedAt - Analyst overrides of derived values
roles - Visibility ("PUBLIC")
Features
The features collection has two features: an INCIDENT point at the reported location, whose properties mirror the incident envelope, and a SMART_ALERT polygon defining the notification boundary. The features collection carries metadata, incidentType, and sourceId at collection level alongside type and features, and each feature's geometry object embeds a copy of the feature's properties. See Feature collections.
Exposure Areas
Manually curated hazards use a single exposure level (level 0, "Limited to No Damage Expected") drawn as a polygon around the affected region. The exposureAssessment block is populated from it, with country and admin breakdowns.
Source
source is null on manually curated hazards; provenance is carried in incident.properties.sourceName.
Sample Response
Note: Coordinate arrays have been replaced with [...] for brevity. In actual API responses, these properties contain complete GeoJSON coordinate arrays. Long text fields have been truncated. All other values are verbatim from the production API as of 2026-09-11.
{
"name": [
{
"locale": "en",
"value": "Famine - South Sudan"
}
],
"description": [
{
"locale": "en",
"value": "Famine has been reported in South Sudan. Reports indicate that at least 7.8 million people have been affected by acute food insecurity, including about 73,000 people facing famine-like conditions in parts of Jonglei and Upper Nile states. At least 1,500 people have been displaced due to drought and water shortages in Kapoeta East County, while hundreds more have been displaced by armed clashes in Raat, Pochalla County. Impacted areas include: Jonglei State, Upper Nile State, Eastern Equatoria, Greater Pibor Administrative Area, Kapoeta East County, Raat, Pochalla County, Unity State, Bentiu IDP camps, and border areas with Ethiopia and Kenya. Moderate drought and water-stress conditions are ... [truncated for brevity]"
}
],
"severity": "WARNING",
"category": "EVENT",
"incident": {
"uuid": "477d36c7-3f17-4d87-a690-96ce28d33109",
"type": "MANMADE",
"sourceId": 3000,
"sourceRecordId": "d9ec1fdf-a250-4d1a-9336-6c8eab6d34ed",
"properties": {
"sourceId": 3000,
"expires": 32503679999000,
"hazardName": "Famine - South Sudan",
"endDate": "2999-12-31T23:59:59Z",
"roles": "PUBLIC",
"locationDescription": "",
"incidentType": "MANMADE",
"description": "Famine has been reported in South Sudan. Reports indicate that at least 7.8 million people have been affected by acute food insecurity, including about 73,000 people facing famine-like conditions in parts of Jonglei and Upper Nile states. At least 1,500 people have been displaced due to drought and water shortages in Kapoeta East County, while hundreds more have been displaced by armed clashes in Raat, Pochalla County. Impacted areas include: Jonglei State, Upper Nile State, Eastern Equatoria, Greater Pibor Administrative Area, Kapoeta East County, Raat, Pochalla County, Unity State, Bentiu IDP camps, and border areas with Ethiopia and Kenya. Moderate drought and water-stress conditions are ... [truncated for brevity]",
"sourceResourceLocations": "[{\"sourceName\":\"PDC Manual Hazard\",\"sourceUrl\":\"\"}]",
"incidentLatitude": 9.39619,
"type": "ACTUAL",
"hazardUUID": "72bc4fe6-c7c7-4aa9-9ce1-3027ee3a29b2",
"rawMessage": "",
"sourceRecordId": "d9ec1fdf-a250-4d1a-9336-6c8eab6d34ed",
"glideUri": "",
"sourceUrl": "",
"Incident_Type": "MANMADE",
"reportDate": "2026-07-20T16:28:47Z",
"sourceUpdatedAt": 1784564927000,
"hazard": "{\"severity\":\"WARNING\",\"uuid\":\"72bc4fe6-c7c7-4aa9-9ce1-3027ee3a29b2\"}",
"featureType": "INCIDENT",
"hazardSeverity": "WARNING",
"eventTime": 1776889812000,
"action": "EVENT_CONTINUED",
"event": "MANMADE",
"sncUrl": "https://hazardbrief.pdc.org/PRODUCTION/ui/index.html?uuid=72bc4fe6-c7c7-4aa9-9ce1-3027ee3a29b2",
"createDate": "2026-07-20T16:28:47Z",
"severity": "WARNING",
"charterUri": "",
"incidentLongitude": 31.80405,
"overrideStartedAt": "true",
"hazardCategory": "EVENT",
"casualties": "null",
"hazardDescription": "Famine has been reported in South Sudan. Reports indicate that at least 7.8 million people have been affected by acute food insecurity, including about 73,000 people facing famine-like conditions in parts of Jonglei and Upper Nile states. At least 1,500 people have been displaced due to drought and water shortages in Kapoeta East County, while hundreds more have been displaced by armed clashes in Raat, Pochalla County. Impacted areas include: Jonglei State, Upper Nile State, Eastern Equatoria, Greater Pibor Administrative Area, Kapoeta East County, Raat, Pochalla County, Unity State, Bentiu IDP camps, and border areas with Ethiopia and Kenya. Moderate drought and water-stress conditions are ... [truncated for brevity]",
"name": "Famine - South Sudan",
"overrideDescription": "Famine has been reported in South Sudan. Reports indicate that at least 7.8 million people have been affected by acute food insecurity, including about 73,000 people facing famine-like conditions in parts of Jonglei and Upper Nile states. At least 1,500 people have been displaced due to drought and water shortages in Kapoeta East County, while hundreds more have been displaced by armed clashes in Raat, Pochalla County. Impacted areas include: Jonglei State, Upper Nile State, Eastern Equatoria, Greater Pibor Administrative Area, Kapoeta East County, Raat, Pochalla County, Unity State, Bentiu IDP camps, and border areas with Ethiopia and Kenya. Moderate drought and water-stress conditions are ... [truncated for brevity]",
"comment": "",
"sourceName": "PDC Manual Hazard",
"category": "EVENT",
"status": "UPDATE",
"masterIncidentId": "3000.1784564927.1",
"eventDate": "2026-04-22T20:30:12Z"
}
},
"uuid": "72bc4fe6-c7c7-4aa9-9ce1-3027ee3a29b2",
"comment": "",
"createdAt": 1784564966,
"relatedHazards": [],
"longitude": 31.80405,
"latitude": 9.39619,
"version": 7,
"alertGeometry": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Polygon",
"coordinates": [...]
},
"properties": null
}
]
},
"features": {
"features": [
{
"id": null,
"type": "Feature",
"properties": {
"severity": "WARNING",
"sourceId": 3000,
"charterUri": "",
"overrideStartedAt": "true",
"endDate": "2999-12-31T23:59:59Z",
"locationDescription": "",
"incidentType": "MANMADE",
"description": "Famine has been reported in South Sudan. Reports indicate that at least 7.8 million people have been affected by acute food insecurity, including about 73,000 people facing famine-like conditions in parts of Jonglei and Upper Nile states. At least 1,500 people have been displaced due to drought and water shortages in Kapoeta East County, while hundreds more have been displaced by armed clashes in Raat, Pochalla County. Impacted areas include: Jonglei State, Upper Nile State, Eastern Equatoria, Greater Pibor Administrative Area, Kapoeta East County, Raat, Pochalla County, Unity State, Bentiu IDP camps, and border areas with Ethiopia and Kenya. Moderate drought and water-stress conditions are ... [truncated for brevity]",
"hazardCategory": "EVENT",
"glideUri": "",
"reportDate": "2026-07-20T16:28:47Z",
"hazard": {
"severity": "WARNING",
"uuid": "72bc4fe6-c7c7-4aa9-9ce1-3027ee3a29b2"
},
"featureType": "INCIDENT",
"name": "Famine - South Sudan",
"overrideDescription": "Famine has been reported in South Sudan. Reports indicate that at least 7.8 million people have been affected by acute food insecurity, including about 73,000 people facing famine-like conditions in parts of Jonglei and Upper Nile states. At least 1,500 people have been displaced due to drought and water shortages in Kapoeta East County, while hundreds more have been displaced by armed clashes in Raat, Pochalla County. Impacted areas include: Jonglei State, Upper Nile State, Eastern Equatoria, Greater Pibor Administrative Area, Kapoeta East County, Raat, Pochalla County, Unity State, Bentiu IDP camps, and border areas with Ethiopia and Kenya. Moderate drought and water-stress conditions are ... [truncated for brevity]",
"comment": "",
"category": "EVENT",
"sncUrl": "https://hazardbrief.pdc.org/PRODUCTION/ui/index.html?uuid=72bc4fe6-c7c7-4aa9-9ce1-3027ee3a29b2",
"createDate": "2026-07-20T16:28:47Z",
"eventDate": "2026-04-22T20:30:12Z"
},
"geometry": {
"coordinates": [
31.80405,
9.39619
],
"type": "Point",
"properties": {
"severity": "WARNING",
"sourceId": 3000,
"charterUri": "",
"overrideStartedAt": "true",
"endDate": "2999-12-31T23:59:59Z",
"locationDescription": "",
"incidentType": "MANMADE",
"description": "Famine has been reported in South Sudan. Reports indicate that at least 7.8 million people have been affected by acute food insecurity, including about 73,000 people facing famine-like conditions in parts of Jonglei and Upper Nile states. At least 1,500 people have been displaced due to drought and water shortages in Kapoeta East County, while hundreds more have been displaced by armed clashes in Raat, Pochalla County. Impacted areas include: Jonglei State, Upper Nile State, Eastern Equatoria, Greater Pibor Administrative Area, Kapoeta East County, Raat, Pochalla County, Unity State, Bentiu IDP camps, and border areas with Ethiopia and Kenya. Moderate drought and water-stress conditions are ... [truncated for brevity]",
"hazardCategory": "EVENT",
"glideUri": "",
"reportDate": "2026-07-20T16:28:47Z",
"hazard": {
"severity": "WARNING",
"uuid": "72bc4fe6-c7c7-4aa9-9ce1-3027ee3a29b2"
},
"featureType": "INCIDENT",
"name": "Famine - South Sudan",
"overrideDescription": "Famine has been reported in South Sudan. Reports indicate that at least 7.8 million people have been affected by acute food insecurity, including about 73,000 people facing famine-like conditions in parts of Jonglei and Upper Nile states. At least 1,500 people have been displaced due to drought and water shortages in Kapoeta East County, while hundreds more have been displaced by armed clashes in Raat, Pochalla County. Impacted areas include: Jonglei State, Upper Nile State, Eastern Equatoria, Greater Pibor Administrative Area, Kapoeta East County, Raat, Pochalla County, Unity State, Bentiu IDP camps, and border areas with Ethiopia and Kenya. Moderate drought and water-stress conditions are ... [truncated for brevity]",
"comment": "",
"category": "EVENT",
"sncUrl": "https://hazardbrief.pdc.org/PRODUCTION/ui/index.html?uuid=72bc4fe6-c7c7-4aa9-9ce1-3027ee3a29b2",
"createDate": "2026-07-20T16:28:47Z",
"eventDate": "2026-04-22T20:30:12Z"
}
},
"incidentType": null,
"sourceId": null
},
{
"id": null,
"type": "Feature",
"properties": {
"severity": "LIMITED",
"featureType": "SMART_ALERT",
"incidentType": "MANMADE"
},
"geometry": {
"coordinates": [...],
"type": "Polygon",
"properties": {
"featureType": "SMART_ALERT",
"severity": "LIMITED",
"incidentType": "MANMADE"
}
},
"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": {
"featureType": "SMART_ALERT",
"severity": "LIMITED"
}
},
"sourceId": null
}
],
"type": "FeatureCollection"
},
"exposureAssessment": {
"population": {
"total": 8460000.0,
"total0_14": 3371486,
"total15_64": 4841915,
"households": 1530000.0,
"vulnerable": 6960000.0,
"total65_Plus": 246200
},
"capital": {
"total": 14700000000.0,
"school": 48,
"hospital": 83
},
"totalByCountry": [
{
"population": {
"total": 8460000.0,
"total0_14": 3371310,
"total15_64": 4841658,
"households": 1530000.0,
"vulnerable": 6960000.0,
"total65_Plus": 246186
},
"country": "SSD",
"capital": {
"total": 14700000000.0,
"school": 48,
"hospital": 83
},
"admin0": "South Sudan",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 14600000000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 20800000.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 696000.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 24000000.0
},
{
"population": {
"total": 447,
"total0_14": 176,
"total15_64": 257,
"households": 95.5,
"vulnerable": 105,
"total65_Plus": 14
},
"country": "ETH",
"capital": {
"total": 121000.0,
"school": 0,
"hospital": 0
},
"admin0": "Ethiopia",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 220000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 315,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 10.5,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 362
},
{
"population": {
"total": 0.0,
"total0_14": 0,
"total15_64": 0,
"households": 0.0,
"vulnerable": 0.0,
"total65_Plus": 0
},
"country": "SDN",
"capital": {
"total": 4450000.0,
"school": 0,
"hospital": 0
},
"admin0": "Sudan",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 0.0,
"waterNeedsUnit": "liter",
"waterNeeds": 0.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 0.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 0.0
}
],
"totalByAdmin": [
{
"population": {
"total": 8460000.0,
"total0_14": 3371310,
"total15_64": 4841658,
"households": 1530000.0,
"vulnerable": 6960000.0,
"total65_Plus": 246186
},
"country": "SSD",
"capital": {
"total": 14700000000.0,
"school": 48,
"hospital": 83
},
"admin0": "South Sudan",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 14600000000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 20800000.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 696000.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 24000000.0
},
{
"population": {
"total": 447,
"total0_14": 176,
"total15_64": 257,
"households": 95.5,
"vulnerable": 105,
"total65_Plus": 14
},
"country": "ETH",
"capital": {
"total": 121000.0,
"school": 0,
"hospital": 0
},
"admin0": "Ethiopia",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 220000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 315,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 10.5,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 362
},
{
"population": {
"total": 0.0,
"total0_14": 0,
"total15_64": 0,
"households": 0.0,
"vulnerable": 0.0,
"total65_Plus": 0
},
"country": "SDN",
"capital": {
"total": 4450000.0,
"school": 0,
"hospital": 0
},
"admin0": "Sudan",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 0.0,
"waterNeedsUnit": "liter",
"waterNeeds": 0.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 0.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 0.0
}
],
"exposureLevels": [
{
"level": "0",
"data": {
"population": {
"total": 8460000.0,
"total0_14": 3371486,
"total15_64": 4841915,
"households": 1530000.0,
"vulnerable": 6960000.0,
"total65_Plus": 246200
},
"capital": {
"total": 14700000000.0,
"school": 48,
"hospital": 83
},
"totalByCountry": [
{
"population": {
"total": 8460000.0,
"total0_14": 3371310,
"total15_64": 4841658,
"households": 1530000.0,
"vulnerable": 6960000.0,
"total65_Plus": 246186
},
"country": "SSD",
"capital": {
"total": 14700000000.0,
"school": 48,
"hospital": 83
},
"admin0": "South Sudan",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 14600000000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 20800000.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 696000.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 24000000.0
},
{
"population": {
"total": 447,
"total0_14": 176,
"total15_64": 257,
"households": 95.5,
"vulnerable": 105,
"total65_Plus": 14
},
"country": "ETH",
"capital": {
"total": 121000.0,
"school": 0,
"hospital": 0
},
"admin0": "Ethiopia",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 220000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 315,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 10.5,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 362
},
{
"population": {
"total": 0.0,
"total0_14": 0,
"total15_64": 0,
"households": 0.0,
"vulnerable": 0.0,
"total65_Plus": 0
},
"country": "SDN",
"capital": {
"total": 4450000.0,
"school": 0,
"hospital": 0
},
"admin0": "Sudan",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 0.0,
"waterNeedsUnit": "liter",
"waterNeeds": 0.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 0.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 0.0
}
],
"totalByAdmin": [
{
"population": {
"total": 447,
"total0_14": 176,
"total15_64": 257,
"households": 95.5,
"vulnerable": 105,
"total65_Plus": 14
},
"country": "ETH",
"capital": {
"total": 121000.0,
"school": 0,
"hospital": 0
},
"admin0": "Ethiopia",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 220000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 315,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 10.5,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 362
},
{
"population": {
"total": 0.0,
"total0_14": 0,
"total15_64": 0,
"households": 0.0,
"vulnerable": 0.0,
"total65_Plus": 0
},
"country": "SDN",
"capital": {
"total": 4450000.0,
"school": 0,
"hospital": 0
},
"admin0": "Sudan",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 0.0,
"waterNeedsUnit": "liter",
"waterNeeds": 0.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 0.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 0.0
},
{
"population": {
"total": 8460000.0,
"total0_14": 3371310,
"total15_64": 4841658,
"households": 1530000.0,
"vulnerable": 6960000.0,
"total65_Plus": 246186
},
"country": "SSD",
"capital": {
"total": 14700000000.0,
"school": 48,
"hospital": 83
},
"admin0": "South Sudan",
"admin1": null,
"admin2": null,
"foodNeedsUnit": "CAL",
"foodNeeds": 14600000000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 20800000.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 696000.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 24000000.0
}
],
"foodNeedsUnit": "CAL",
"foodNeeds": 14600000000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 20800000.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 696000.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 24000000.0
},
"exposureDescription": "Limited to No Damage Expected"
}
],
"hazardUuid": "",
"hazardType": "",
"version": "",
"timestamp": "1784564944014",
"exposureDescription": "",
"foodNeedsUnit": "CAL",
"foodNeeds": 14600000000.0,
"waterNeedsUnit": "liter",
"waterNeeds": 20800000.0,
"wasteNeedsUnit": "100 liter",
"wasteNeeds": 696000.0,
"shelterNeedsUnit": "sq meters",
"shelterNeeds": 24000000.0
},
"type": "MANMADE",
"creator": "RICHTER",
"source": null,
"startedAt": 1776889812,
"updatedAt": 1784564943,
"endedAt": 32503679999
}
