Upcoming update to Riskline Alerts API

Riskline will be updating the Alerts API. The new version, 4.1, will be released on 1 October 2024.

As this is a minor version update, it will be backwards compatible. It will not affect your current integration with any existing version of the Alerts API.

While no action is required at this time, we strongly encourage you to adopt the latest Alert API version to take advantage of these new features.

This update includes the following changes:

1 - Fields to identify the perpetrator and target in conflict, terrorism and crime related alerts. For example, the data will clarify whether an attacker is from an organised, armed group or other organisation and whether the civilians have been targeted.

This will be reflected in 3 new fields:

Actor 1: describes the “perpetrator” of the attack or crime
Actor 2: describes the “target” or “victim” of the attack or crime
Civilians Targeted: it will indicate “Yes” if civilians were targeted, whether intentionally or not, or “No”, if no civilians were involved in the incident.

There are several possible values for the "Actor" fields:

"State forces": collective actors, including military and police, that are recognized to perform government functions over a given territory. Examples: United States Army soldiers, London Metropolitan police, Senegalese gendarme
"Armed non-state forces": Organised, armed groups that do not have the backing of a government of a given territory. This includes groups that may aspire to control a government and currently control some territory, but are generally not internationally recognised as a state. Examples: Hamas fighters, Islamic State in West Africa Province militants.
"Unarmed non-state group": organised groups of any kind that are not armed. Examples: UAW trade union, Students Against Tyranny protest group, Riskline analysts (the most fierce).
"Armed civilians": Unorganised, armed groups or individuals that generally lack any cohesive affiliation.
"Unarmed civilians": Unorganised, unarmed groups or individuals that generally lack any cohesive affiliation
"Unknown": When the perpetrator or target is not known.

2 - New fields for flight numbers: For incidents involving a specific flight (e.g. crashes, hijackings, bomb threats), the flight number will now be included along with optional fields for departure and arrival airports and dates, if known at the time of the incident.

For each individual flight, the following fields will be included:

Airline of the flight
Flight number: 3- or 4-digit number of the flight
Departure Airport (Optional) if known
Departure Date (Optional): in local time, if known.
Arrival Airport (Optional): the originally scheduled arrival airport, if known
Arrival Date (Optional): the originally schedule arrival date, in known

3 - The "Crime and Corruption" category will be renamed to "Crime"

4 - Location(s) and radius when an alert's impact is for travellers. This is optional, depending on the case, it will not be included in all alerts. Currently, only alerts with an impact for all have this option

5 - New subcategories will be added:

Travel Safety and Disruptions category:

Air travel
Airspace
Borders and Entry
Identification
Road travel
Maritime travel
Rail Travel
Transit
Exit
Public transport
Movement control orders
LGBTQ travel
Female travel
Transport strike

Health and Medical category:

Healthcare Strike

Natural and Environmental category:

Hail

List of all subcategories with their corresponding ID

ID	Name
8	Avalanches
9	Blizzards
10	Dangerous wildlife
11	Drought
12	Dust/Sand Storms
13	Earthquakes
14	Flooding
15	Heat Waves
16	Hurricanes/Typhoons/Tropical Cyclones
17	Landslides/Mudslides
18	Smog/Haze and Pollution
19	Surf/Rip currents
20	Tornadoes
21	Tsunami
22	Volcanic Eruptions
23	Wildfires
24	Windstorms
25	Fog
26	Rainfall
27	Security Alert
28	Thunderstorms
29	Extreme cold
30	Visa
31	Kidnap and Ransom
32	Air travel
33	Airspace
34	Borders and entry
35	Identification
36	Road travel
37	Maritime travel
38	Rail travel
39	Transit
40	Exit
41	Public transport
42	Movement control orders
43	LGBTQ travel
44	Female travel
45	Transport strike
46	Healthcare strike
47	Hail

Samples

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"
  }
}