[GET] Get incidents

Modified on Tue, 11 Feb at 3:48 AM

https://api.s7risk.com

The Incident API provides well constructed high-quality, highly-tailored and scalable threat intelligence data.

GET /incidentsGet incidents

This endpoint gets all available incidents. The incidents returned can be filtered by adding search and filtering parameters to your request.

HTTP Request

curl -X GET 'https://api.s7risk.com/incidents' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer {{YOUR_AUTHENTICATION_TOKEN}}' \
  -d 'search=missile' \
  -d 'category=eq:661b7990-10f9-4a19-84b2-8a6030951314' \
  -d 'type=eq:190945a1-2347-4020-8ed1-4e152537b47d' \
  -d 'startedAt=lte:1549436460' \
  -d 'startedInPeriod=eq:P1D' \
  -d 'endedAt=lte:1549436460' \
  -d 'ongoing=false' \
  -d 'reporter=in:142949e0-0646-4160-a614-4fedb1e8dd1e;47690e92-77f3-4195-9500-00213682c4f7;fe6b54e7-d71b-4224-8e5c-21d21433e194' \
  -d 'area=in:[[[-79.22039956443662,21.418262318933035],[-79.22039956443662,21.418262318933035],[-79.22039956443662,21.418262318933035]]]' \
  -d 'country=eq:USA' \
  -d 'reportedAt=gt:1549544353' \
  -d 'reportedInPeriod=eq:P1D' \
  -d 'reviewedAt=gt:1549544353' \
  -d 'sort=duration:desc' \
  -d 'page=1' \
  -d 'pageSize=10' \
  --compressed

Headers

NameTypeRequiredDescription
Authorizationstring✔️Your authentication token (see the Auth API section for more information)

Query Parameters

NameTypeFilterDescription
searchstring~Search incident summaries and descriptions using the given search term
categorystringeq / neq / in / ninA semi-colon separated list of Incident Category UUIDs
typestringeq / neq / in / ninA semi-colon separated list of Incident Type UUIDs
startedAttimestampeq / neq / gt / gte / lt / lte / bt / nbtFilter by an incident’s start date/time
startedInPeriodintervaleqFilter by the ISO_8601 date period when the incident first started
endedAttimestampeq / neq / gt / gte / lt / lte / bt / nbtFilter by an incident’s start date/time
ongoingbooleq:true / eq:falseShow incidents that are currently on-going or have ended
themestringeq / neq / in / ninA semi-colon separated list of Theme IDs
taggedstringeq / neq / in / ninA semi-colon separated list of tag slugs
areastringin / ninFilter by geographical area. Must be the co-ordinates of a polygon
countrystringeq / neq / in / ninFilter by country code
continentstringeq / neq / in / ninFilter by continent code
involvingstringeq / neq / in / ninA semi-colon separated list of individual or group UUIDs
reporterstringeq / inA semi-colon separated list of reporter UUIDs
affectsstringeq / neq / in / ninA semi-colon separated list of affected sectors
impactinteq / neq / gt / gte / lt / lte / bt / nbtFilter by an incident’s impact rating
nearstringin / ninFilter by the proximity to features on a map. Takes the format: in:mapId;kilometers
reportedAttimestampeq / neq / gt / gte / lt / lte / bt / nbtFilter by the date/time when the incident was first reported
reportedInPeriodintervaleqFilter by the ISO_8601 date period when the incident was first reported
reviewedAttimestampeq / neq / gt / gte / lt / lte / bt / nbtFilter by the date/time when the incident was reviewed for publishing
updatedAttimestampeq / neq / gt / gte / lt / lte / bt / nbtFilter by the date/time when the incident was last updated
sortstring~Sort the results by the given properties. If no sort order is specified then results are sorted by their relevancy. Multiple sorting can be applied by semi-colon separating them
pageint~A paginated result set. Defaults to 1
pageSizeint~A limited result set. Defaults to 100

HTTP Response

{
    "data": [
        {
            "id": "IN-224368",
            "organisationId": "08e310b2-2043-4d46-a821-0fa2fca70cf7",
            "reporter": {
                "id": "ac9bd988-a81f-454f-991b-56f8005daf21"
            },
            "summary": "U.S. test Minuteman III ICBM missile from Vandenberg Air Force Base in California",
            "description": "A Minuteman III Intercontinental Ballistic Missile was fired from the Vandenberg Air Force Base in California. The missile was launched across the Pacific towards the Kwajalein Atoll in the Pacific Ocean. The test was a routine test that had been scheduled for a while.",
            "casualties": {
                "civilianDeaths": 1,
                "civilianInjuries": 0,
                "criminalDeaths": 0,
                "criminalInjuries": 0,
                "emergencyDeaths": 0,
                "emergencyInjuries": 0,
                "militaryDeaths": 0,
                "militaryInjuries": 0,
                "policeDeaths": 0,
                "policeInjuries": 0
            },
            "map": {
                "id": "5ee72772-c015-4de4-b4f7-a5ac92772d8d",
                "type": "FeatureCollection",
                "features": [
                    {
                        "id": "139db349-c45f-4af0-8edb-ae422c94c5f7",
                        "type": "Feature",
                        "geometry": {
                            "type": "Point",
                            "coordinates": [
                                -86,
                                39
                            ]
                        },
                        "properties": {
                            "icon": "other",
                            "meta": [],
                            "name": "Location",
                            "colour": "#FEFEFE",
                            "description": "Location of Incident"
                        }
                    }
                ]
            },
            "isOngoing": false,
            "status": "approved",
            "category": {
                "id": "661b7990-10f9-4a19-84b2-8a6030951314",
                "name": "Indirect Weapons",
                "colour": "#2F4155"
            },
            "type": {
                "id": "190945a1-2347-4020-8ed1-4e152537b47d",
                "name": "Ballistic Missile"
            },
            "location": {
                "longitude": -120.577868,
                "latitude": 34.740757,
                "accuracy": 1,
                "timeZone": "America/Los_Angeles",
                "utcOffset": -28800
            },
            "countries": [
                {
                    "code": "USA",
                    "name": "United States",
                    "alpha2": null
                }
            ],
            "startedAt": {
                "timestamp": 1549436460,
                "localTime": "2019-02-05T23:01:00-0800"
            },
            "endedAt": {
                "timestamp": 1549436460,
                "localTime": "2019-02-05T23:01:00-0800"
            },
            "impact": {
                "rating": -1,
                "shortDescription": "Unknown",
                "longDescription": "Impact has not been assessed or is unknown."
            },
            "counts": {
                "affectedSectors": 1,
                "casualties": 0,
                "involvedParties": 1,
                "links": 0,
                "mapFeatures": 1,
                "narratives": 0,
                "references": 1,
                "themes": 0,
                "tags": 1,
                "watchers": 0
            },
            "assigneeId": "1bef8953-dc70-4bda-aeaf-f213f8ce0a63",
            "narratives": [
                {
                    "id": "67a9b6f8-367e-4806-9625-8c7eab580cac",
                    "body": "Some sources have claimed the images shared of the patrol are fake and are in fact from a previous date.",
                    "reporterId": "ac9bd988-a81f-454f-991b-56f8005daf21"
                }
            ],
            "affectedSectors": [
                {
                    "id": "ce54716d-aaf8-4aaa-af45-2afcc5f998cf",
                    "sector": {
                        "id": "550a4aa0-6d6f-4be2-ba33-f35d159ee686",
                        "name": "Police/Law"
                    }
                }
            ],
            "references": [
                {
                    "id": "a996eee1-358d-4158-a9fa-4278a5b5ebc2",
                    "link": "https://www.theindychannel.com/news/local-news/crime/man-found-dead-after-barricading-himself-shooting-at-police-in-fishers",
                    "title": "Man found dead after barricading himself, shooting at police in Fishers",
                    "medium": {
                        "id": "a27663b3-331b-449e-aaf1-c851d6712625",
                        "name": "WRTV"
                    },
                    "source": {
                        "id": "91a5e6f1-2227-4a15-a647-df2d65f45560",
                        "name": "Unknown"
                    },
                    "status": "pending",
                    "citation": "Unknown - WRTV - 23 Mar 2020",
                    "publishedAt": 1584921600
                }
            ],
            "involvedParties": [
                {
                    "id": "fe5ad0c5-7ee8-4a1a-8a3c-77897dec376f",
                    "type": "group",
                    "involvement": "Actor",
                    "group": {
                        "id": "8e5bdef3-90f2-4360-92b9-639d78651a2b",
                        "name": "United States Air Force"
                    }
                }
            ],
            "themes": [
                {
                    "id": "TH-202",
                    "name": "Counterterrorism Operations in Europe in 2020",
                    "colour": "#D60D52",
                    "identifiedAt": "2021-01-21T10:19:06+0000",
                    "counts": {
                        "affectedSectors": 15,
                        "casualties": 24,
                        "incidents": 84,
                        "involvedParties": 44,
                        "tags": 87
                    },
                    "trendHistory": []
                }
            ],
            "tags": [
                {
                    "name": "shooting",
                    "slug": "shooting"
                }
            ],
            "isWatched": false,
            "draftedAt": 1584014400,
            "reportedAt": 1549544353,
            "reviewedAt": 1549544353,
            "updatedAt": 1585064487,
            "originId": null
        }
    ]
}

Success

CodeStatusDescription
200SuccessReturns a body containing all valid incidents

Errors

CodeStatusDescription
401UnauthorizedExpired or Invalid Authentication token
422Unprocessable EntityIncorrect or invalid search or filter parameter

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article