Core Endpoints
Get Alerts
Request a list of all alerts throughout your entire environment
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 alertsall- 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, msdefenderatpnumber
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
Red Alerts
Red Alerts
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
Amber Alerts
Amber Alerts
Warnings that should be addressed soonExamples:
- Agent configuration drift
- Pending security updates
- Device not seen online in 7-14 days
- Firewall disabled temporarily
Green/Info
Green/Info
Informational alerts or resolved issuesExamples:
- Agent successfully installed
- Configuration corrected
- Device came back online
- Patch successfully applied
Related Endpoints
Devices
Get full device details for affected items