FieldExample ValueFormatSpecial FormatExplanation
id278209IntegerUnique ID number for Alert
titlePro-choice activists to rally on 8 July in Tallahassee, FloridaStringTitle of the Alert
textPro-choice activists plan to rally at the Florida State Capitol (400 South Monroe Street) in Tallahassee, Florida, from 17:00 local time (21:00 GMT) on 8 July, in support of abortion access after a Supreme Court ruling restricted it.StringText of the Alert
adviceAnticipate heightened security and associated disruptions in the vicinity of the rally site on 8 July. Plot route bypasses.StringAdvice of the Alert
takes_placefutureStringpast, now, futureIndicates when the incident described in the Alert takes place according to the time of publication
is_publishedTRUEBooleanIndicates if the Alert is published or not
is_activeTRUEBooleanIndicates if the impact of the Alert is active or not
start_date2022-07-08StringDate format
YYYY-MM-DD
The day of an incident or event, in local time
end_date2022-07-09StringDate format
YYYY-MM-DD
The first full day after an incident or event ends, in local time

risk_level

FieldExample ValueFormatSpecial FormatExplanation
id2Integer1 to 5Risk Level in number form
nameModerateStringLow, Moderate, Medium, High, ExtremeRisk Level in text form

category

FieldExample ValueFormatSpecial FormatExplanation
id3Integer1 to 7Category in number form
nameDemonstrations and UnrestStringPolitical Developments
Conflict and Terrorism
Demonstration and Unrest
Crime and Corruption
Natural and Environmental
Health and Medical
Travel Safety and Disruptions
Category in text form, they are numbered in the order listed here

subcategories

FieldExample ValueFormatSpecial FormatExplanation
id27Integer8 to 28Subcategory in number form
nameSecurity AlertStringAvalanches
Blizzards
Dangerous wildlife
Drought
Dust/Sand Storms
Earthquakes
Flooding
Heat Waves
Hurricanes/Typhoons/Tropical Cyclones
Landslides/Mudslides
Smog/Haze and Pollution
Surf/Rip currents
Tornadoes
Tsunami
Volcanic Eruptions
Wildfires
Windstorms
Fog
Rainfall
Security Alert
Thunderstorms
Subcategory in text form for the categories:
Natural and Environmental
Travel Safety and Disruption

Numbered in the order listed here
FieldExample ValueFormatSpecial FormatExplanation
impact_typefor_allStringfor_all, for_travellersIndicates 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.

Point Example

FieldExample ValueFormatSpecial FormatExplanation
typegeojsonStringgeojson, country, region, airportIndicates the type of the geographic feature
content see subfields belowArray
content.typeFeatureCollection
content.featuressee subfields belowArray
content.features.typeFeatureStringIndicates the type of geographic feature
content.features.propertiessee subfields below
content.features.properties.radius1000Integerin metresImpact radius of the geographic feature
content.features.properties.descriptionFlorida State Capitol - 400 S Monroe St, Tallahassee, FL 32399, United StatesStringDescription of geographic feature
content.features.properties.geometry_id33199IntegerUnique ID given by Riskline for the geographic feature
content.features.properties.alert_id278209IntegerCorresponds to the Alert ID
content.features.properties.risk_level_id2Integer1 to 5Corresponds to Alert Risk Level
content.features.properties.category_id3Integer1 to 7Corresponds to Alert Category
content.features.geometry see subfields below
content.features.geometry.typePointStringDescribes the type of geographic feature
content.features.geometry.coordinates see subfields belowArray
content.features.geometry.coordinates.0-84.2825836Number-90 to 90Longitude (for point geometry)
content.features.geometry.coordinates.130.4381328Number-180 to 180Latitude (for point geometry)

see an example below

"impacted_locations": [
      {
        "type": "geojson",
        "content": {
          "type": "FeatureCollection",
          "features": [
            {
              "type": "Feature",
              "properties": {
                "radius": 1000,
                "description": "Massachusetts Ave - Massachusetts Ave, Cambridge, MA, USA",
                "geometry_id": "42755",
                "alert_id": "284807",
                "risk_level_id": "2",
                "category_id": "7"
              },
              "geometry": {
                "type": "Point",
                "coordinates": [
                  -71.12005599999999,
                  42.37831850000001
                ]
              }
            }
          ]
        }
      }

Airport Example

FieldExample ValueFormatSpecial FormatExplanation
typeairportStringairportIndicates the type of the geographic feature
iata_codeBCNStringIATA Three-letter CodeIATA code for airport
nameJosep Tarradellas Barcelona-El Prat Airport, Barcelona, ESStringName of airport
country_iso_codeESStringISO 3166 Alpha-2 CodeCountry or territory location of airport

Country Example

FieldExample ValueFormatSpecial FormatExplanation
typecountryStringcountryIndicates the type of the geographic feature
iso_codeESStringISO 3166 Alpha-2 CodeISO Code of country or territory
nameSpainStringName of country or territory

Region Example

FieldExample ValueFormatSpecial FormatExplanation
typeregionStringregionIndicates the type of the geographic feature
iso_codeES-MDStringISO 3166-2 CodeISO Code for region
nameCommunity of MadridStringName of the region
country_iso_codeESStringISO 3166 Alpha-2 CodeCountry or territory location of region

City Example

FieldExample ValueFormatSpecial FormatExplanation
typecityStringcityIndicates the type of the geographic feature
codeGROStringThree-letter codeCode for city
nameGironaStringName of city
country_iso_codeESStringISO 3166 Alpha-2 CodeISO Code of country or territory of the region

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.

Airport Example

FieldExample ValueFormatSpecial FormatExplanation
originssee subfields belowArray
typeairportStringIndicates the type of the geographic feature
iata_codeFRUStringIATA Three-letter CodeIATA code for airport
nameManas International Airport, Bishkek, KGStringName of the airport
country_iso_codeKGStringISO 3166 Alpha-2 CodeISO code of country or territory
destinations see subfields belowArray
typeairportStringIndicates the type of the geographic feature
iata_codeURCStringIATA Three-letter CodeIATA code for airport
nameÜrümqi Diwopu International Airport, Urumqi, CNStringName of the airport
country_iso_codeCNStringISO 3166 Alpha-2 CodeISO code of country or territory

Country Example

FieldExample ValueFormatSpecial FormatExplanation
origins see subfields belowArray
typecountryStringcountryIndicates the type of the geographic feature
iso_codeESStringISO 3166 Alpha-2 CodeISO code of country or territory
nameSpainStringName of the country or territory
destinations see subfields belowArray
typecountryStringcountryIndicates the type of the geographic feature
iso_codeEGStringISO 3166 Alpha-2 CodeISO code of country or territory
nameEgyptStringName of the country or territory

impacted_carriers_type

FieldExample ValueFormatSpecial FormatExplanation
impacted_carriers_typeaviationArrayaviation, maritime, rail, ground, public transportModes 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 example

FieldExample ValueFormatSpecial FormatExplanation
typeairlineStringType of carrier
nameRyanairStringName of carrier
codessee subfields belowArray
codes.type.0iataStringiata, icaoType of code use to identify carrier
codes.code.0FRStringCode of carrier
codes.type.1icaoStringiata, icaoType of code use to identify carrier
codes.code.1RYRStringCode of carrier

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

See the following example:

"relations": [
      {
        "type": "country",
        "iso_code": "US",
        "name": "United States of America"
      },
      {
        "type": "airport",
        "iata_code": "DEN",
        "name": "Denver International Airport, Denver, US",
        "country_iso_code": "us"
      },
      {
        "type": "airport",
        "iata_code": "FLG",
        "name": "Flagstaff Pulliam Airport, Grand Canyon, US",
        "country_iso_code": "us"
      },
      {
        "type": "airline",
        "name": "United Airlines",
        "codes": [
          {
            "type": "iata",
            "code": "UA"
          },
          {
            "type": "icao",
            "code": "UAL"
          }
        ]
      }
    ]

meta

FieldExample ValueFormatSpecial FormatExplanation
company_id1IntegerCompany ID number
languageenStringLanguage code