https://api.s7risk.com
The Incident API provides well constructed high-quality, highly-tailored and scalable threat intelligence data.
Get 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
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | ✔️ | Your authentication token (see the Auth API section for more information) |
Query Parameters
| Name | Type | Filter | Description |
|---|---|---|---|
search | string | ~ | Search incident summaries and descriptions using the given search term |
category | string | eq / neq / in / nin | A semi-colon separated list of Incident Category UUIDs |
type | string | eq / neq / in / nin | A semi-colon separated list of Incident Type UUIDs |
startedAt | timestamp | eq / neq / gt / gte / lt / lte / bt / nbt | Filter by an incident’s start date/time |
startedInPeriod | interval | eq | Filter by the ISO_8601 date period when the incident first started |
endedAt | timestamp | eq / neq / gt / gte / lt / lte / bt / nbt | Filter by an incident’s start date/time |
ongoing | bool | eq:true / eq:false | Show incidents that are currently on-going or have ended |
theme | string | eq / neq / in / nin | A semi-colon separated list of Theme IDs |
tagged | string | eq / neq / in / nin | A semi-colon separated list of tag slugs |
area | string | in / nin | Filter by geographical area. Must be the co-ordinates of a polygon |
country | string | eq / neq / in / nin | Filter by country code |
continent | string | eq / neq / in / nin | Filter by continent code |
involving | string | eq / neq / in / nin | A semi-colon separated list of individual or group UUIDs |
reporter | string | eq / in | A semi-colon separated list of reporter UUIDs |
affects | string | eq / neq / in / nin | A semi-colon separated list of affected sectors |
impact | int | eq / neq / gt / gte / lt / lte / bt / nbt | Filter by an incident’s impact rating |
near | string | in / nin | Filter by the proximity to features on a map. Takes the format: in:mapId;kilometers |
reportedAt | timestamp | eq / neq / gt / gte / lt / lte / bt / nbt | Filter by the date/time when the incident was first reported |
reportedInPeriod | interval | eq | Filter by the ISO_8601 date period when the incident was first reported |
reviewedAt | timestamp | eq / neq / gt / gte / lt / lte / bt / nbt | Filter by the date/time when the incident was reviewed for publishing |
updatedAt | timestamp | eq / neq / gt / gte / lt / lte / bt / nbt | Filter by the date/time when the incident was last updated |
sort | string | ~ | 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 |
page | int | ~ | A paginated result set. Defaults to 1 |
pageSize | int | ~ | 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
| Code | Status | Description |
|---|---|---|
| 200 | Success | Returns a body containing all valid incidents |
Errors
| Code | Status | Description |
|---|---|---|
| 401 | Unauthorized | Expired or Invalid Authentication token |
| 422 | Unprocessable Entity | Incorrect 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
Feedback sent
We appreciate your effort and will try to fix the article