Skip to main content
GET
/
v1
/
threats
List threats
curl --request GET \
  --url https://api.intrace.ai/v1/threats \
  --header 'X-API-Key: <api-key>'
{
  "threats": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "title": "<string>",
      "severity": "critical",
      "status": "active",
      "pinned": true,
      "created_at": "2023-11-07T05:31:56Z",
      "updated_at": "2023-11-07T05:31:56Z",
      "attribution_types": [
        "<string>"
      ],
      "sources": [
        "<string>"
      ],
      "affected_assets": [
        {
          "asset_id": "<string>",
          "asset_name": "<string>",
          "asset_type": "<string>",
          "distance_km": 123
        }
      ],
      "version_count": 123,
      "development_count": 123,
      "description": "<string>",
      "threat_rationale": "<string>",
      "threat_type": "<string>",
      "location": "<string>",
      "location_country": "<string>",
      "coordinates": {
        "lat": 123,
        "lng": 123
      },
      "observed_at": "2023-11-07T05:31:56Z",
      "expires_at": "2023-11-07T05:31:56Z",
      "likelihood": "<string>",
      "impact_severity": "<string>",
      "risk_score": 123,
      "risk_level": "<string>",
      "likelihood_rationale": "<string>",
      "impact_rationale": "<string>",
      "dismissal_reason": "<string>",
      "location_precision_level": "<string>",
      "location_uncertainty_km": 123,
      "last_version_at": "2023-11-07T05:31:56Z",
      "latest_development_title": "<string>"
    }
  ],
  "total": 123,
  "assets": [
    {
      "asset_id": "<string>",
      "name": "<string>",
      "type": "<string>",
      "lat": 123,
      "lng": 123,
      "country": "<string>",
      "address": "<string>",
      "monitoring_radius_km": 123
    }
  ]
}
Returns evaluated threats, not raw event rows.

​
Query Parameters

ParameterTypeRequiredDescription
asset_idstring[]NoLimit to one or more affected assets
severitystringNoFilter by threat severity
statusstringNoFilter by threat status
include_dismissedbooleanNoWhen true, include dismissed threats
limitintegerNoMax items, default 100
offsetintegerNoRow offset

​
Response

{
  "threats": [
    {
      "id": "4f5d1cc9-d4cc-49a1-a3fc-5ec93d674bc8",
      "title": "Protest blocks access road near Lagos HQ",
      "severity": "high",
      "status": "active",
      "threatType": "civic_activity.protest",
      "location": "Victoria Island, Lagos",
      "locationCountry": "NG",
      "coordinates": {
        "lat": 6.431,
        "lng": 3.421
      },
      "observedAt": "2026-04-18T08:10:00Z",
      "affectedAssets": [
        {
          "assetId": "lagos-hq",
          "assetName": "Lagos HQ",
          "assetType": "facility",
          "distanceKm": 1.8
        }
      ],
      "riskLevel": "high",
      "developmentCount": 2,
      "versionCount": 3
    }
  ],
  "total": 1,
  "assets": [
    {
      "assetId": "lagos-hq",
      "name": "Lagos HQ",
      "type": "facility",
      "lat": 6.4541,
      "lng": 3.3947,
      "monitoringRadiusKm": 12
    }
  ]
}

​
Example Request

curl -H "X-API-Key: your-api-key" "https://api.intrace.ai/v1/threats?asset_id=lagos-hq&status=active"

Authorizations

​
X-API-Key
string
header
required

Query Parameters

​
asset_id
​
severity
enum<string>
Available options:
critical,
high,
medium,
low,
negligible
​
status
enum<string>
Available options:
active,
monitoring,
contained,
resolved,
dismissed,
ended
​
include_dismissed
boolean
default:false
​
limit
integer
default:100
Required range: 1 <= x <= 5000
​
offset
integer
default:0
Required range: x >= 0

Response

200 - application/json

Threat list.

​
threats
object[]
required
​
total
integer
required
​
assets
object[]
required