Alert fields

Alert responses follow a stable top-level structure.

However, field presence does not imply population.
Depending on the alert, some fields may contain empty arrays ([]), empty objects ({}), or null values.

Use the tabs next to this one to see which fields are always populated and which ones are contextual.

The sections below describe each field and object in detail.

{
  "alert": {
    "id": "405276",
    "title": "Airstrike targets al-Shabaab officials in Buale, Middle Juba region",
    "text": "Military officials reported that security forces targeted al-Shabaab militants in a house in Buale, Middle Juba region, with an airstrike, during morning hours local time. Further details regarding potential casualties were not immediately available.",
    "advice": "For business-critical travel in the country, vary routines, avoid travel after dark and only venture beyond the perimeter of a secured compound with an embassy-approved escort.",
    "takes_place": "now",
    "is_published": true,
    "is_active": false,
    "start_date": "2026-01-15",
    "end_date": "2026-01-16",
    "risk_level": { ... },
    "category": { ... },
    "subcategories": [ ... ],
    "perpetrators_and_targets": { ... },
    "impact_type": "for_all",
    "impacted_areas": [ ... ],
    "travel_routes": [ ... ],
    "impacted_carriers_type": [ ... ],
    "impacted_carriers": [ ... ],
    "impacted_flights": [ ... ],
    "relations": [ ... ]
  },
  "meta": {
    "company_id": "1",
    "language": "en"
  }
}

Field	Format	Example
id	String	404556
title	String	Pro-choice activists to rally on 8 July in Tallahassee, Florida
text	String	Pro-choice activists plan to rally at the Florida State Capitol (400 South Monroe Street) in Tallahassee, Florida...
advice	String	Anticipate heightened security and associated disruptions in the vicinity of the rally site on 8 July. Plot route bypasses.
takes_place	String (Enum)	past \| now \| future
is_published	Boolean	true \| false
is_active	Boolean	true \| false
start_date	Date (YYYY-MM-DD)	2026-01-14
end_date	Date (YYYY-MM-DD)	2026-01-16

takes_place   Indicates when the incident occurs relative to publication
is_published  Indicates whether the alert is published
is_active     Indicates whether the alert impact is currently active
start_date    The day the event starts, in local time
end_date      The first full day after the event ends, in local time

Risk level

"risk_level": {
  "id": "1",
  "name": "Low"
}

Field	Format	Example
id	String (Enum)	1 \| 2 \| 3 \| 4 \| 5
name	String (Enum)	Low \| Moderate \| Medium \| High \| Extreme

Category

"category": {
  "id": "7",
  "name": "Travel Safety and Disruptions"
}

Field	Format	Example
id	String (Enum)	1 \| 2 \| 3 \| 4 \| 5 \| 6 \| 7
name	String (Enum)	Political Developments \| Conflict and Terrorism \| Demonstration and Unrest \| Crime \| Natural and Environmental \| Health and Medical \| Travel Safety and Disruptions

Subcategories

"subcategories": [
  {
    "id": "32",
    "name": "Air travel"
  },
  {
    "id": "27",
    "name": "Security Alert"
  }
]

Field	Format	Example
id	String (Enum)	8 \| 9 \| ... \| 47
name	String (Enum)	See the possible values listed in the tabs below, grouped by category

📘
While subcategories are conceptually associated with specific categories (e.g. "Flooding" typically aligns with "Natural and Environmental"), this relationship is not strictly enforced. Subcategories can be assigned independently of the selected category.

Kidnap and Ransom

Perpetrators and targets

"perpetrators_and_targets": {
  "actor_1": "state forces",
  "actor_2": "armed non-state forces",
  "civilian_targeting": "no"
}

Field	Format	Example
actor_1	String (Enum)	state forces \| armed non-state forces \| unarmed non-state group \| armed civilians \| unarmed civilians
actor_2	String (Enum)	state forces \| armed non-state forces \| unarmed non-state group \| armed civilians \| unarmed civilians
civilian_targeting	String (Enum)	yes \| no

actor_1  Primary actor described in the alert (i.e. the perpetrator)
actor_2  Secondary actor in the alert, most likely the target (i.e. the victim)

📘
This object is contextual and only meaningful for alerts in the Conflict and Terrorism and Crime categories.
When the information is not available, the object is still returned but some or all of its fields may be null. This applies to all fields, including enum-based ones such as civilian_targeting.
Find the definitions for perpetrators and targets here

Impact type

Field	Format	Example
impact_type	String (Enum)	for_all \| for_travellers

impact_type  Indicates whether the impact of the alert is for all or only for travellers

Impacted areas

The structure of the API fields under "impacted_areas" depends on the type of geographic feature that is affected. Below are the fields for each type:

Field	Format	Example
type	String (Enum)	geojson \| country \| region \| city \| airport \| offshore

GeoJSON (Point)

"impacted_areas": [
  {
    "type": "geojson",
    "content": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {
            "radius": 25000,
            "description": "Warner County No. 5 - Warner County No. 5, AB, Canada",
            "geometry_id": "263781",
            "alert_id": "388657",
            "risk_level_id": "2",
            "category_id": "7"
          },
          "geometry": {
            "type": "Point",
            "coordinates": [-112.1138079, 49.2807071]
          }
        }
      ]
    }
  }
]

📘
The content follows the GeoJSON standard (RFC 7946) and contains a FeatureCollection. Each Feature includes a properties object and a geometry object as defined below.

Properties

Field	Format	Example
radius	Integer	1000
description	String	Florida State Capitol - 400 S Monroe St, Tallahassee, FL 32399, United States
geometry_id	String	263781
alert_id	String	388657
risk_level_id	String	2
category_id	String	7

Geometry

Field	Format	Example
type	String	Point
coordinates	Array	[-112.1138079, 49.2807071]

Country

"impacted_areas": [
  {
    "type": "country",
    "iso_code": "HT",
    "name": "Haiti"
  }
]

Field	Format	Example
iso_code	String (ISO 3166 Alpha-2 Code)	ES
name	String	Spain

Region

"impacted_areas": [
  {
    "type": "region",
    "iso_code": "DE-BE",
    "name": "Berlin",
    "country_iso_code": "DE"
  }
]

Field	Format	Example
iso_code	String (ISO 3166-2)	ES-MD
name	String	Spain
country_iso_code	String (ISO 3166 Alpha-2)	ES

City

"impacted_areas": [
  {
    "type": "city",
    "code": "BUH",
    "name": "Bucharest",
    "country_iso_code": "RO"
  }
]

Field	Format	Example
code	String (IATA three-letter code)	GRO
name	String	Girona
country_iso_code	String (ISO 3166 Alpha-2)	ES

Airport

"impacted_areas": [
  {
    "type": "airport",
    "iata_code": "BDP",
    "name": "Bhadrapur Airport, Bhadrapur, NP",
    "country_iso_code": "NP"
  }
]

Field	Format	Example
iata_code	String	BCN
name	String	Josep Tarradellas Barcelona-El Prat Airport, Barcelona, ES
country_iso_code	String (ISO 3166 Alpha-2)	ES

Offshore

"impacted_areas": [
  {
    "type": "offshore",
    "name": "Yellow Sea"
  }
]

Field	Format	Example
name	String	Bohai Sea

Travel routes

If a specific travel route is impacted by the event, this section will be populated based on which geographic feature is affected. Below are the fields for each type.

Field	Format	Example
type	String (Enum)	country \| region \| city \| airport

Country

"travel_routes": [
  {
    "origins": [
      {
        "type": "country",
        "iso_code": "PL",
        "name": "Poland"
      }
    ],
    "destinations": [
      {
        "type": "country",
        "iso_code": "BY",
        "name": "Belarus"
      }
    ]
  }
]

Field	Format	Example
iso_code	String (ISO 3166 Alpha-2 Code)	ES
name	String	Spain

Region

"travel_routes": [
  {
    "origins": [
      {
        "type": "region",
        "iso_code": "CA-AB",
        "name": "Alberta",
        "country_iso_code": "CA"
      }
    ],
    "destinations": [
      {
        "type": "region",
        "iso_code": "US-MT",
        "name": "Montana",
        "country_iso_code": "US"
      }
    ]
  }
]

Field	Format	Example
iso_code	String (ISO 3166-2)	CA-AB
name	String	Alberta
country_iso_code	String (ISO 3166 Alpha-2)	CA

City

"travel_routes": [
  {
    "origins": [
      {
        "type": "city",
        "code": "TTT",
        "name": "Taitung",
        "country_iso_code": "TW"
      }
    ],
    "destinations": [
      {
        "type": "city",
        "code": "KYD",
        "name": "Lanyu (Orchid Island)",
        "country_iso_code": "TW"
      }
    ]
  }
]

Field	Format	Example
code	String (IATA three-letter code)	GRO
name	String	Girona
country_iso_code	String (ISO 3166 Alpha-2)	ES

Airport

"travel_routes": [
  {
    "origins": [
      {
        "type": "airport",
        "iata_code": "UKB",
        "name": "Kobe Airport, Osaka, JP",
        "country_iso_code": "JP"
      }
    ],
    "destinations": [
      {
        "type": "airport",
        "iata_code": "KIX",
        "name": "Kansai International Airport, Osaka, JP",
        "country_iso_code": "JP"
      }
    ]
  }
]

Field	Format	Example
iata_code	String	BCN
name	String	Josep Tarradellas Barcelona-El Prat Airport, Barcelona, ES
country_iso_code	String (ISO 3166 Alpha-2)	ES

Impacted carriers type

Field	Format	Example
impacted_carriers_type	Array	aviation \| maritime \| rail \| ground \| public transport

impacted_carriers_type  Modes of transport impacted

Impacted carriers

If a carrier is impacted by the event, this section will be populated based on which type of carrier is affected. Below are the fields for each type.

Airline

"impacted_carriers": [
  {
    "type": "airline",
    "name": "LATAM",
    "codes": [
      {
        "type": "iata",
        "code": "LA"
      },
      {
        "type": "icao",
        "code": "LAN"
      }
    ]
  }
]

Field	Format	Example
name	String	LATAM

Codes

Field	Format	Example
type	String (Enum)	iata, icao
code	String	LA

Impacted flights

"impacted_flights": [
  {
    "airline": {
      "name": "LATAM",
      "codes": [
        {
          "type": "iata",
          "code": "LA"
        },
        {
          "type": "icao",
          "code": "LAN"
        }
      ]
    },
    "flight_number": "132",
    "departure_airport": {
      "iata_code": "SCL",
      "name": "Comodoro Arturo Merino Benítez International Airport, Santiago, CL",
      "country_iso_code": "CL"
    },
    "departure_date": "2026-01-02",
    "arrival_airport": {
      "iata_code": "ANF",
      "name": "Cerro Moreno Airport, Antofagasta, CL",
      "country_iso_code": "CL"
    },
    "arrival_date": "2026-01-03"
  }
]

Field	Format	Example
airline	Object
↳ name	String	LATAM
↳ codes	Array
↳ type	String (Enum)	iata \| icao
↳ code	String	LA
flight_number	String	132
departure_airport	Object
↳ iata_code	String	ANF
↳ name	String	Cerro Moreno Airport, Antofagasta, CL
↳ country_iso_code	String (ISO 3166 Alpha-2)	CL
departure_date	Date (YYYY-MM-DD)	2026-01-02
arrival_airport	Object
↳ iata_code	String	ANF
↳ name	String	Cerro Moreno Airport, Antofagasta, CL
↳ country_iso_code	String (ISO 3166 Alpha-2)	CL
arrival_date	Date (YYYY-MM-DD)	2026-01-02

🚧
Due to legacy reasons, when departure_airport or arrival_airport data is not available, these fields will be returned as empty objects ({}), rather than containing keys with null values. In such cases, the object exists, but its internal fields (iata_code, name, country_iso_code) are omitted.

Relations

Each Alert will restate a list of all geographic locations included in the alert, in the Impact section and all related higher level administrative divisions. This section allows clients to file, search for and display on a map alerts as they see fit. For example, an alert impacting only the city of "Paris" will also include in the relations data for region "Ile de France" and country "France".

"relations": [
  {
    "type": "alert",
    "id": "363964",
    "title": "Unionised public transport workers to strike in Berlin on 27-28 January"
  },
  {
    "type": "country",
    "iso_code": "CL",
    "name": "Chile"
  },
  {
    "type": "region",
    "iso_code": "CL-AN",
    "name": "Antofagasta",
    "country_iso_code": "CL"
  },
  {
    "type": "region",
    "iso_code": "CL-RM",
    "name": "Santiago Metropolitan Region",
    "country_iso_code": "CL"
  },
  {
    "type": "city",
    "code": "SCL",
    "name": "Santiago de Chile",
    "country_iso_code": "CL"
  },
  {
    "type": "city",
    "code": "ANF",
    "name": "Antofagasta",
    "country_iso_code": "CL"
  },
  {
    "type": "airport",
    "iata_code": "SCL",
    "name": "Comodoro Arturo Merino Benítez International Airport, Santiago, CL",
    "country_iso_code": "CL"
  },
  {
    "type": "airport",
    "iata_code": "ANF",
    "name": "Cerro Moreno Airport, Antofagasta, CL",
    "country_iso_code": "CL"
  },
  {
    "type": "airline",
    "name": "LATAM",
    "codes": [
      {
        "type": "iata",
        "code": "LA"
      },
      {
        "type": "icao",
        "code": "LAN"
      }
    ]
  },
  {
    "type": "geojson",
    "content": {
      "type": "FeatureCollection",
      "features": [
        {
          "type": "Feature",
          "properties": {
            "radius": 0,
            "description": "Arturo Merino Benitez International Airport - Av. Armando Cortínez Ote. 1704, Pudahuel, Región Metropolitana, Chile",
            "geometry_id": null,
            "alert_id": "403941",
            "risk_level_id": "2",
            "category_id": "7"
          },
          "geometry": {
            "type": "Point",
            "coordinates": [-70.7944022, -33.3897615]
          }
        }
      ]
    }
  }
]

Alert

Field	Format	Example
id	String	405388
title	String	Unionised public transport workers to strike in Berlin on 27-28 January

Country

Field	Format	Example
iso_code	String (ISO 3166 Alpha-2 Code)	ES
name	String	Spain

Region

Field	Format	Example
code	String (IATA three-letter code)	GRO
name	String	Girona
country_iso_code	String (ISO 3166 Alpha-2)	ES

City

Field	Format	Example
code	String (IATA three-letter code)	GRO
name	String	Girona
country_iso_code	String (ISO 3166 Alpha-2)	ES

Airport

Field	Format	Example
iata_code	String	BCN
name	String	Josep Tarradellas Barcelona-El Prat Airport, Barcelona, ES
country_iso_code	String (ISO 3166 Alpha-2)	ES

Airline

Field	Format	Example
name	String	LATAM
codes	Array
↳ type	String (Enum)	iata \| icao
↳ code	String	LA

GeoJSON (Point)

📘
The content follows the GeoJSON standard (RFC 7946) and contains a FeatureCollection. Each Feature includes a properties object and a geometry object as defined below.

Properties

Field	Format	Example
radius	Integer	1000
description	String	Florida State Capitol - 400 S Monroe St, Tallahassee, FL 32399, United States
geometry_id	String	263781
alert_id	String	388657
risk_level_id	String	2
category_id	String	7

Geometry

Field	Format	Example
type	String	Point
coordinates	Array	[-112.1138079, 49.2807071]

Meta

Field	Format	Example
company_id	String	1
language	String	en