--- title: "API sample for threats and alerts" slug: "api-sample-for-threats-and-alerts" tags: ["EDR with Forensics (EDRF)", "Endpoint Security", "Incident Responder"] updated: 2026-08-25T15:20:27Z published: 2026-08-26T19:31:36Z canonical: "docs.trellix.com/api-sample-for-threats-and-alerts" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.trellix.com/llms.txt > Use this file to discover all available pages before exploring further. # API sample for threats and alerts The threats and alerts APIs let you retrieve detected threats, the endpoints they affect, the individual detections that make up each threat, and the raw security alerts behind them. Use these endpoints to feed threat data into incident response workflows, SIEM correlation, or long-term archival. **Endpoints** | Endpoint | Description | | --- | --- | | [GET - Threats](/v1/docs/get-threats) | Use this to retrieve a filtered, paginated list of threats. | | [GET - Threats by ID](/v1/docs/get-threats-by-id) | Use this to retrieve full details for a single threat. | | [GET - Affected hosts by threat id](/v1/docs/get-affected-hosts-by-threat-id) | Use this to list every endpoint where a threat was detected. | | [GET - Detections by threat id](/v1/docs/get-detections-by-threat-id) | Use this to retrieve the individual detection events within a threat. | | [Get Alerts (v2)](/v1/docs/get-alerts) | Use this to retrieve raw security alerts. | | [Get Alerts (v3)](/v1/docs/get-alerts-1) | Use this to retrieve raw security alerts with enriched host data. | ### Common reference All endpoints return a severity value on the s0–s5 scale. For details, see [Security levels](/v1/docs/severity-levels-2).