Skip to main content
GET

Overview

The Alerts endpoint provides access to security issues and Vitals health problems detected across your environment. Filter by resolution status or specific integration.

Parameters

string
required
Filter alerts based on their current stateOptions:
  • allunresolved - All unresolved alerts
  • all - All alerts (resolved and unresolved)
  • resolved - Only resolved alerts
string
Name of an integration you would like to query against. Leave blank to query all integrations.Example: automox, crowdstrike, msdefenderatp
number
default:"0"
Set the start position of the data returned by the API
number
default:"0"
Limit each request by the provided number. Leave blank or as 0 to return all data available

Authentication

string
required
Your ThreatAware API key
string
default:"application/json"
Response format

Response

number
The starting position of this result set
number
The number of results returned
number
Total number of alerts available
boolean
Whether the request was successful
number
HTTP status code
string
Status message
array

Use Cases

SIEM Integration

Forward security alerts to Splunk, Sentinel, QRadar, or other SIEMs

SOC Dashboard

Build real-time security operations dashboards

Automated Ticketing

Create ServiceNow or Jira tickets automatically from alerts

Alert Metrics

Track Mean Time To Detect (MTTD) and Mean Time To Resolve (MTTR)

Alert States

Critical security issues requiring immediate attentionExamples:
  • EDR agent not functioning
  • Encryption disabled on sensitive device
  • Critical vulnerability unpatched for 30+ days
  • MFA not enabled for admin account
Warnings that should be addressed soonExamples:
  • Agent configuration drift
  • Pending security updates
  • Device not seen online in 7-14 days
  • Firewall disabled temporarily
Informational alerts or resolved issuesExamples:
  • Agent successfully installed
  • Configuration corrected
  • Device came back online
  • Patch successfully applied

Devices

Get full device details for affected items