JSON structure
{
"alert": {
"id": "string",
"title": "string",
"text": "string",
"advice": "string",
"takes_place": "string",
"is_published": true,
"is_active": true,
"start_date": "string",
"end_date": "string",
"risk_level": {
"id": "string",
"name": "string"
},
"category": {
"id": "string",
"name": "string"
},
"subcategories": [
{
"id": "string",
"name": "string"
}
],
"perpetrators_and_targets": {
"actor_1": "string",
"actor_2": "string",
"civlian_targeting": "string"
},
"impact_type": "string",
"impacted_areas": [
{
"type": "string"
}
],
"travel_routes": [
{
"origins": [
{}
],
"destinations": [
{}
]
}
],
"impacted_carriers_type": [
"string"
],
"impacted_carriers": [
{
"type": "string"
}
],
"impacted_flights": [
{
"airline": {
"name": "string",
"codes": [
{
"type": "string",
"code": "string"
}
]
},
"flight_number": "string",
"departure_airport": {
"iata_code": "string",
"name": "string",
"country_iso_code": "string"
},
"departure_date": "string",
"arrival_airport": {
"iata_code": "string",
"name": "string",
"country_iso_code": "string"
},
"arrival_date": "string"
}
],
"relations": [
{
"type": "string"
}
]
},
"meta": {
"company_id": "string",
"language": "string"
}
}JSON example with Perpetrator-Victim information
{
"alert": {
"id": "350334",
"title": "Renewed clashes reported in Khartoum and Omdurman",
"text": "Local sources reported heavy clashes between Sudanese Armed Forces (SAF) and Rapid Support Forces (RSF) in Khartoum, including in Kafouri, Hallat Koko and Al Riyadh areas, Khartoum Bahri and Omdurman, particularly in Karari, on 18 September. Approximately 73 people were injured in RSF bombing which targeted the Sabreen Market in Omdurman.",
"advice": "Defer non-essential travel to Sudan. If evacuation is not possible, seek shelter in reinforced facilities.",
"takes_place": "past",
"is_published": true,
"is_active": true,
"start_date": "2024-09-18",
"end_date": "2024-09-19",
"risk_level": {
"id": "4",
"name": "High"
},
"category": {
"id": "2",
"name": "Conflict and Terrorism"
},
"subcategories": [],
"perpetrators_and_targets": {
"actor_1": "state forces",
"actor_2": "armed non-state forces",
"civilian_targeting": "yes"
},
"impact_type": "for_all",
"impacted_areas": [
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 2500,
"description": "Kafouri - Kafouri, Khartoum North, Sudan",
"geometry_id": "180292",
"alert_id": "350334",
"risk_level_id": "4",
"category_id": "2"
},
"geometry": {
"type": "Point",
"coordinates": [
32.5701454,
15.6356935
]
}
},
{
"type": "Feature",
"properties": {
"radius": 2500,
"description": "Al Riyadh - Al Riyadh, Khartoum, Sudan",
"geometry_id": "180293",
"alert_id": "350334",
"risk_level_id": "4",
"category_id": "2"
},
"geometry": {
"type": "Point",
"coordinates": [
32.5683826,
15.5790102
]
}
},
{
"type": "Feature",
"properties": {
"radius": 5000,
"description": "Omdurman - Omdurman, Sudan",
"geometry_id": "180294",
"alert_id": "350334",
"risk_level_id": "4",
"category_id": "2"
},
"geometry": {
"type": "Point",
"coordinates": [
32.4806894,
15.6475782
]
}
},
{
"type": "Feature",
"properties": {
"radius": 1000,
"description": "Sabrin Shanqeeti market - PFGG+QXX, Omdurman, Sudan",
"geometry_id": "180295",
"alert_id": "350334",
"risk_level_id": "4",
"category_id": "2"
},
"geometry": {
"type": "Point",
"coordinates": [
32.4774959,
15.726996
]
}
},
{
"type": "Feature",
"properties": {
"radius": 5000,
"description": "Karari Locality Government Offices - MFGW+9GM, Omdurman, Sudan",
"geometry_id": "180296",
"alert_id": "350334",
"risk_level_id": "4",
"category_id": "2"
},
"geometry": {
"type": "Point",
"coordinates": [
32.4963033,
15.6759949
]
}
},
{
"type": "Feature",
"properties": {
"radius": 5000,
"description": "Khartoum North - Khartoum North, Sudan",
"geometry_id": "180297",
"alert_id": "350334",
"risk_level_id": "4",
"category_id": "2"
},
"geometry": {
"type": "Point",
"coordinates": [
32.5485873,
15.6569409
]
}
},
{
"type": "Feature",
"properties": {
"radius": 2500,
"description": "Hillat Koko Market - JH9R+279, Khartoum, Sudan",
"geometry_id": "180298",
"alert_id": "350334",
"risk_level_id": "4",
"category_id": "2"
},
"geometry": {
"type": "Point",
"coordinates": [
32.590736,
15.6175314
]
}
}
]
}
}
],
"travel_routes": [],
"impacted_carriers_type": [],
"impacted_carriers": [],
"impacted_flights": [],
"relations": [
{
"type": "country",
"iso_code": "SD",
"name": "Sudan"
},
{
"type": "region",
"iso_code": "SD-KH",
"name": "Khartoum",
"country_iso_code": "SD"
},
{
"type": "city",
"code": "KRT",
"name": "Khartoum",
"country_iso_code": "SD"
},
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 0,
"description": "Kafouri - Kafouri, Khartoum North, Sudan",
"geometry_id": null,
"alert_id": "350334",
"risk_level_id": "4",
"category_id": "2"
},
"geometry": {
"type": "Point",
"coordinates": [
32.5701454,
15.6356935
]
}
}
]
}
}
]
},
"meta": {
"company_id": "1",
"language": "en"
}
}JSON example with Impacted Flight information
{
"alert": {
"id": "350062",
"title": "Qantas flight en route to Brisbane airport diverted to Rockhampton Airport",
"text": "Qantas flight QF 1871 from Townsville Airport (TSV/YBTL), which was en route to Brisbane Airport (BNE/YBBN), was diverted to Rockhampton Airport (ROK/YBRK) in Queensland, due to a suspected pressurisation issue. The flight safely landed in Rockhampton.",
"advice": "Contact booking agents for updated itineraries and rebooking options.",
"takes_place": "now",
"is_published": true,
"is_active": false,
"start_date": "2024-09-17",
"end_date": "2024-09-18",
"risk_level": {
"id": "2",
"name": "Moderate"
},
"category": {
"id": "7",
"name": "Travel Safety and Disruptions"
},
"subcategories": [],
"perpetrators_and_targets": {
"actor_1": null,
"actor_2": null,
"civlian_targeting": null
},
"impact_type": "for_travellers",
"impacted_areas": [
{
"type": "airport",
"iata_code": "ROK",
"name": "Rockhampton Airport, Rockhampton, AU",
"country_iso_code": "au"
}
],
"travel_routes": [],
"impacted_carriers_type": [],
"impacted_carriers": [],
"impacted_flights": [
{
"airline": {
"name": "Qantas",
"codes": [
{
"type": "iata",
"code": "QF"
},
{
"type": "icao",
"code": "QFA"
}
]
},
"flight_number": "1871",
"departure_airport": {
"iata_code": "TSV",
"name": "Townsville Airport, Townsville, AU",
"country_iso_code": "au"
},
"departure_date": "2024-09-17",
"arrival_airport": {
"iata_code": "BNE",
"name": "Brisbane International Airport, Brisbane, AU",
"country_iso_code": "au"
},
"arrival_date": "2024-09-17"
}
],
"relations": [
{
"type": "country",
"iso_code": "AU",
"name": "Australia"
},
{
"type": "region",
"iso_code": "AU-QLD",
"name": "Queensland",
"country_iso_code": "AU"
},
{
"type": "city",
"code": "ROK",
"name": "Rockhampton",
"country_iso_code": "AU"
},
{
"type": "city",
"code": "TSV",
"name": "Townsville",
"country_iso_code": "AU"
},
{
"type": "city",
"code": "BNE",
"name": "Brisbane",
"country_iso_code": "AU"
},
{
"type": "airport",
"iata_code": "BNE",
"name": "Brisbane International Airport, Brisbane, AU",
"country_iso_code": "au"
},
{
"type": "airport",
"iata_code": "ROK",
"name": "Rockhampton Airport, Rockhampton, AU",
"country_iso_code": "au"
},
{
"type": "airport",
"iata_code": "TSV",
"name": "Townsville Airport, Townsville, AU",
"country_iso_code": "au"
},
{
"type": "airline",
"name": "Qantas",
"codes": [
{
"type": "iata",
"code": "QF"
},
{
"type": "icao",
"code": "QFA"
}
]
},
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 0,
"description": "Rockhampton Airport - 81 Canoona Rd, West Rockhampton QLD 4700, Australia",
"geometry_id": null,
"alert_id": "350062",
"risk_level_id": "2",
"category_id": "7"
},
"geometry": {
"type": "Point",
"coordinates": [
150.4783476,
-23.3781386
]
}
}
]
}
}
]
},
"meta": {
"company_id": "1",
"language": "en"
}
}JSON example with Alert affecting multiple regions
{
"alert": {
"id": "377229",
"title": "Anti-Trump activists to rally nationwide on 14 June - Update",
"text": "Anti-Trump activists will rally on 14 June in Salt Lake City (Presidents Circle) and Santa Fe (Capitol) at 10:00 local time (16:00 GMT), Boise (Capitol) and Boulder (Library) at 11:00 and Denver (Capitol), Colorado Springs (City Hall), Helena (Capitol), Billings (Yellowstone County Courthouse) and Bozeman (Main St/Rouse Ave) at 12:00.",
"advice": "Anticipate heightened security and associated disruptions near all protest sites on 14 June. Plot route bypasses.",
"takes_place": "future",
"is_published": true,
"is_active": true,
"start_date": "2025-06-14",
"end_date": "2025-06-15",
"risk_level": {
"id": "2",
"name": "Moderate"
},
"category": {
"id": "3",
"name": "Demonstrations and Unrest"
},
"subcategories": [],
"perpetrators_and_targets": {
"actor_1": null,
"actor_2": null,
"civilian_targeting": null
},
"impact_type": "for_all",
"impacted_areas": [
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "Presidents' Cir - Presidents' Cir, Salt Lake City, UT, USA",
"geometry_id": "239429",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-111.8511489,
40.7645417
]
}
},
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "New Mexico State Capitol - 490 Old Santa Fe Trail, Santa Fe, NM 87501, United States",
"geometry_id": "239430",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-105.9394865,
35.6822308
]
}
},
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "Idaho State Capitol - 700 W Jefferson St, Boise, ID 83702, United States",
"geometry_id": "239431",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-116.199599,
43.6177493
]
}
},
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "Main Library - Boulder Public Library District - 1001 Arapahoe Ave, Boulder, CO 80302, United States",
"geometry_id": "239432",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-105.281769,
40.013952
]
}
},
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "Colorado State Capitol - 200 E Colfax Ave, Denver, CO 80203, United States",
"geometry_id": "239433",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-104.9848118,
39.7393441
]
}
},
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "Colorado Springs City Hall - 107 N Nevada Ave # 300, Colorado Springs, CO 80903, United States",
"geometry_id": "239434",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-104.8211184,
38.8356566
]
}
},
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "Montana State Capitol - Montana State Capitol, 1301 E 6th Ave, Helena, MT 59601, USA",
"geometry_id": "239435",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-112.0177705,
46.5855819
]
}
},
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "Yellowstone County Courthouse - 217 N 27th St, Billings, MT 59101, United States",
"geometry_id": "239436",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-108.5057869,
45.784338
]
}
},
{
"type": "Feature",
"properties": {
"radius": 500,
"description": "E Main St & S Rouse Ave - E Main St & S Rouse Ave, Bozeman, MT 59715, USA",
"geometry_id": "239437",
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-111.0320635,
45.6793512
]
}
}
]
}
}
],
"travel_routes": [],
"impacted_carriers_type": [],
"impacted_carriers": [],
"impacted_flights": [],
"relations": [
{
"type": "country",
"iso_code": "US",
"name": "United States of America"
},
{
"type": "region",
"iso_code": "US-CO",
"name": "Colorado",
"country_iso_code": "US"
},
{
"type": "region",
"iso_code": "US-ID",
"name": "Idaho",
"country_iso_code": "US"
},
{
"type": "region",
"iso_code": "US-MT",
"name": "Montana",
"country_iso_code": "US"
},
{
"type": "region",
"iso_code": "US-NM",
"name": "New Mexico",
"country_iso_code": "US"
},
{
"type": "region",
"iso_code": "US-UT",
"name": "Utah",
"country_iso_code": "US"
},
{
"type": "city",
"code": "DEN",
"name": "Denver",
"country_iso_code": "US"
},
{
"type": "city",
"code": "COS",
"name": "Colorado Springs",
"country_iso_code": "US"
},
{
"type": "city",
"code": "WBU",
"name": "Boulder",
"country_iso_code": "US"
},
{
"type": "city",
"code": "SAF",
"name": "Santa Fe",
"country_iso_code": "US"
},
{
"type": "city",
"code": "BZN",
"name": "Bozeman",
"country_iso_code": "US"
},
{
"type": "city",
"code": "BIL",
"name": "Billings",
"country_iso_code": "US"
},
{
"type": "city",
"code": "HLN",
"name": "Helena",
"country_iso_code": "US"
},
{
"type": "city",
"code": "BOI",
"name": "Boise",
"country_iso_code": "US"
},
{
"type": "city",
"code": "SLC",
"name": "Salt Lake City",
"country_iso_code": "US"
},
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 0,
"description": "Presidents' Cir - Presidents' Cir, Salt Lake City, UT, USA",
"geometry_id": null,
"alert_id": "377229",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-111.8511489,
40.7645417
]
}
}
]
}
}
]
},
"meta": {
"company_id": "1",
"language": "en"
}
}JSON example with Alert on a country level
{
"alert": {
"id": "371371",
"title": "Constitutional referendum to be held on 21 September",
"text": "Authorities announced that a referendum on the new Constitution will be held on 21 September, in a first step in the return to civilian power. The junta, in power since the September 2021 coup, has claimed this year will be crucial to complete the return to constitutional order after failing to keep its previous commitments to transfer power before the end of 2024.",
"advice": "Anticipate heightened security and associated disruptions near electoral infrastructure and government offices.",
"takes_place": "future",
"is_published": true,
"is_active": true,
"start_date": "2025-09-21",
"end_date": "2025-09-22",
"risk_level": {
"id": "2",
"name": "Moderate"
},
"category": {
"id": "1",
"name": "Political Developments"
},
"subcategories": [],
"perpetrators_and_targets": {
"actor_1": null,
"actor_2": null,
"civilian_targeting": null
},
"impact_type": "for_all",
"impacted_areas": [
{
"type": "country",
"iso_code": "GN",
"name": "Guinea"
}
],
"travel_routes": [],
"impacted_carriers_type": [],
"impacted_carriers": [],
"impacted_flights": [],
"relations": [
{
"type": "country",
"iso_code": "GN",
"name": "Guinea"
},
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 0,
"description": "Conakry - Conakry, Guinea",
"geometry_id": null,
"alert_id": "371371",
"risk_level_id": "2",
"category_id": "1"
},
"geometry": {
"type": "Point",
"coordinates": [
-13.7119312,
9.5090945
]
}
}
]
}
}
]
},
"meta": {
"company_id": "1",
"language": "en"
}
}JSON example with City alert in the future with more location pins
{
"alert": {
"id": "377751",
"title": "Taxi drivers' protest planned in Madrid on 28 May",
"text": "A major taxi protest in Madrid is planned for 28 May in response to the granting of 8,500 new VTC licenses to Cabify. The protest will begin at 10:00 local time (08:00 GMT) from the Ministry of Economy and march along Paseo de la Castellana, affecting traffic from 09:30-14:00. Several streets and plazas will face closures and disruptions, and 24 EMT bus lines will have modified routes during this time.",
"advice": "Anticipate robust security/disruptions in the affected areas. Plot route bypasses.",
"takes_place": "future",
"is_published": true,
"is_active": true,
"start_date": "2025-05-28",
"end_date": "2025-05-29",
"risk_level": {
"id": "2",
"name": "Moderate"
},
"category": {
"id": "3",
"name": "Demonstrations and Unrest"
},
"subcategories": [
{
"id": "36",
"name": "Road travel"
},
{
"id": "41",
"name": "Public transport"
}
],
"perpetrators_and_targets": {
"actor_1": null,
"actor_2": null,
"civilian_targeting": null
},
"impact_type": "for_all",
"impacted_areas": [
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 1000,
"description": "Ministry of Economy and Finance Madrid - Plaza de Chamberí, 8, Chamberí, 28010 Madrid, Spain",
"geometry_id": "240576",
"alert_id": "377751",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-3.6967468,
40.4324657
]
}
},
{
"type": "Feature",
"properties": {
"radius": 2500,
"description": "Paseo de la Castellana, Madrid, Spain",
"geometry_id": "240577",
"alert_id": "377751",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-3.691548928488345,
40.44049666703046
]
}
}
]
}
}
],
"travel_routes": [],
"impacted_carriers_type": [
"ground",
"public transport"
],
"impacted_carriers": [],
"impacted_flights": [],
"relations": [
{
"type": "country",
"iso_code": "ES",
"name": "Spain"
},
{
"type": "region",
"iso_code": "ES-MD",
"name": "Community of Madrid",
"country_iso_code": "ES"
},
{
"type": "city",
"code": "MAD",
"name": "Madrid",
"country_iso_code": "ES"
},
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 0,
"description": "Ministry of Economy and Finance Madrid - Plaza de Chamberí, 8, Chamberí, 28010 Madrid, Spain",
"geometry_id": null,
"alert_id": "377751",
"risk_level_id": "2",
"category_id": "3"
},
"geometry": {
"type": "Point",
"coordinates": [
-3.6967468,
40.4324657
]
}
}
]
}
}
]
},
"meta": {
"company_id": "1",
"language": "en"
}
}JSON example with Update
{
"alert": {
"id": "377636",
"title": "Officials to restrict access to Kanlaon Volcano danger zone from 28 May - Update",
"text": "Updated reports indicated that officials will once again restrict access within the six-kilometre (3.7-mile) danger zone around Kanlaon Volcano from 28 May, amid fears of an eruption following recent seismic activity. Authorities maintained an Alert Level 3.",
"advice": "Follow all official directives. Defer travel within a six-kilometre (3.7-mile) radius of the volcano.",
"takes_place": "future",
"is_published": true,
"is_active": true,
"start_date": "2025-05-28",
"end_date": "2025-05-29",
"risk_level": {
"id": "3",
"name": "Medium"
},
"category": {
"id": "5",
"name": "Natural and Environmental"
},
"subcategories": [
{
"id": "22",
"name": "Volcanic Eruptions"
}
],
"perpetrators_and_targets": {
"actor_1": null,
"actor_2": null,
"civilian_targeting": null
},
"impact_type": "for_all",
"impacted_areas": [
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 10000,
"description": "Mount Kanlaon - Mount Kanlaon, Negros Occidental, Philippines",
"geometry_id": "240344",
"alert_id": "377636",
"risk_level_id": "3",
"category_id": "5"
},
"geometry": {
"type": "Point",
"coordinates": [
123.1330438,
10.4115924
]
}
}
]
}
}
],
"travel_routes": [],
"impacted_carriers_type": [],
"impacted_carriers": [],
"impacted_flights": [],
"relations": [
{
"type": "alert",
"id": "375779",
"title": "Kanlaon Volcano eruption causes ashfall and disrupts flights in Negros Island region"
},
{
"type": "country",
"iso_code": "PH",
"name": "Philippines"
},
{
"type": "region",
"iso_code": "PH-18",
"name": "Negros Island Region",
"country_iso_code": "PH"
},
{
"type": "geojson",
"content": {
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"properties": {
"radius": 0,
"description": "Mount Kanlaon - Mount Kanlaon, Negros Occidental, Philippines",
"geometry_id": null,
"alert_id": "377636",
"risk_level_id": "3",
"category_id": "5"
},
"geometry": {
"type": "Point",
"coordinates": [
123.1330438,
10.4115924
]
}
}
]
}
}
]
},
"meta": {
"company_id": "1",
"language": "en"
}
}