Risk Incident (post)

Request

Authorization

Add parameter in header

x-api-key

Example:

x-api-key: ********************

Body Params application/json

source_system_id

string <uuid>

required

The distinct identifier of the partner system tasked with supplying this data

risk_incidents

array[object (Risk Incident) {20}]

required

incident_type_code

string

required

Code for the Incident Type

incident_type_name

string

required

Name of the Incident Type

language_code_2

string

required

The language used in the threat incident data

risk_impact

enum<integer> <int32>

required

Risk Impact

Allowed values:

-112345

risk_summary

string

required

Summary of the Risk Incident

risk_detail

string

required

More information pertaining to the Risk Incident

country_code

string

required

Country (code 3) of the Risk Incident

Incident_address

string

required

Physical address of the Incident

incident_latitude

number <double>

required

Incident Latitude

incident_longitude

number <double>

required

Incident Longitude

geofence_radius

integer

required

Geofence Radius in meters

incident_start_datetime

string <date-time> | null

required

Incident Start Date and Time (format: YYYY-MM-DDThh:mm:ssZ)

incident_end_datetime

string <date-time> | null

optional

Incident End Date and Time (format: YYYY-MM-DDThh:mm:ssZ)

is_ongoing

boolean

required

Is this an on-going Risk Incident

status

string

required

Status of the Risk Incident

involved_parties

array[object (Involved Parties) {3}]

optional

Parties engaged in the Risk Incident

references

array[object (Risk Reference) {7}]

optional

References pertaining to the Risk Incident

tags

array[object (Incident Tag) {1}]

optional

source_system_link

string

optional

Link from the Source System to obtain further details regarding the incident

source_system_ref

string

required

The distinctive reference number for this record within the partner system

Example

{
    "source_system_id": "b0ddbc9c-12e7-d82c-0fe6-13e96bf1f28d",
    "risk_incidents": [
        {
            "incident_type_code": "O01-0018",
            "incident_type_name": "Threat/Warning",
            "language_code_2": "en",
            "risk_impact": 2,
            "risk_summary": "Poster calls for action by ISIS-K targeting Amsterdam Dance Event, Amsterdam",
            "risk_detail": "A poster depicting a gun being pointed with several locations of high-profile mass gatherings in Europe and the United States was circulated online.",
            "country_code": "NLD",
            "Incident_address": "1097 DN Amsterdam, Netherlands",
            "incident_latitude": 52.368398,
            "incident_longitude": 4.877863,
            "geofence_radius": 10000,
            "incident_start_datetime": "2025-05-11 17:35:24.487823+00",
            "incident_end_datetime": "2025-05-15 12:30:24.487823+00",
            "is_ongoing": false,
            "status": "approved",
            "involved_parties": [
                {
                    "type": "group",
                    "involvement": "Actor",
                    "group": "Islamic State (IS)"
                }
            ],
            "references": [
                {
                    "title": "TracTerrorism on X",
                    "citation": "@TraceTerrorism - Twitter / X - 11 May 2025",
                    "link": "https://darling-step-mother.name/",
                    "status": "approved",
                    "medium": "Twitter / X",
                    "source": "@TraceTerrorism",
                    "published_date": "2025-05-11 16:35:24.487823+00"
                }
            ],
            "tags": [
                {
                    "tag_name": "terrorism"
                }
            ],
            "source_system_link": "https://www.s7risk.com/",
            "source_system_ref": "2025-05-11-125ttArsd002"
        }
    ]
}

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://dev.your-api-server.comrisk_incident' \
--header 'Content-Type: application/json' \
--header 'x-api-key;' \
--data-raw '{
    "source_system_id": "b0ddbc9c-12e7-d82c-0fe6-13e96bf1f28d",
    "risk_incidents": [
        {
            "incident_type_code": "O01-0018",
            "incident_type_name": "Threat/Warning",
            "language_code_2": "en",
            "risk_impact": 2,
            "risk_summary": "Poster calls for action by ISIS-K targeting Amsterdam Dance Event, Amsterdam",
            "risk_detail": "A poster depicting a gun being pointed with several locations of high-profile mass gatherings in Europe and the United States was circulated online.",
            "country_code": "NLD",
            "Incident_address": "1097 DN Amsterdam, Netherlands",
            "incident_latitude": 52.368398,
            "incident_longitude": 4.877863,
            "geofence_radius": 10000,
            "incident_start_datetime": "2025-05-11 17:35:24.487823+00",
            "incident_end_datetime": "2025-05-15 12:30:24.487823+00",
            "is_ongoing": false,
            "status": "approved",
            "involved_parties": [
                {
                    "type": "group",
                    "involvement": "Actor",
                    "group": "Islamic State (IS)"
                }
            ],
            "references": [
                {
                    "title": "TracTerrorism on X",
                    "citation": "@TraceTerrorism - Twitter / X - 11 May 2025",
                    "link": "https://darling-step-mother.name/",
                    "status": "approved",
                    "medium": "Twitter / X",
                    "source": "@TraceTerrorism",
                    "published_date": "2025-05-11 16:35:24.487823+00"
                }
            ],
            "tags": [
                {
                    "tag_name": "terrorism"
                }
            ],
            "source_system_link": "https://www.s7risk.com/",
            "source_system_ref": "2025-05-11-125ttArsd002"
        }
    ]
}'

Request

Request samples

Responses