--- title: "GET - Affected hosts by threat id" slug: "get-affected-hosts-by-threat-id" tags: ["EDR with Forensics (EDRF)", "Endpoint Security"] updated: 2026-08-26T19:31:09Z published: 2026-08-26T19:31:09Z canonical: "docs.trellix.com/get-affected-hosts-by-threat-id" --- > ## 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. # GET - Affected hosts by threat id ### Overview This endpoint retrieves a paginated list of all endpoints where a specific threat has been detected. Target a threat by its `threat_id` in the path. The response contains an array of endpoint objects, which can be sorted and filtered by time. Use this API to determine the scope of an incident. After a threat is identified, call this endpoint to get the full list of affected endpoints. This list is the basis for scoping your investigation and for creating a target list for remediation actions. ### Authentication Authentication type: Bearer Token, API Key. You can create a token using client credentials obtained through the [developer portal](https://developer.manage.trellix.com/). The API Key (`x-api-key`) is provided in your onboarding email or on the API Access Management page. ### Path *(or URL)* ``` GET https://{Trellix EDR_gateway_URL}/edr/v2/threats/{threat_id}/affectedhosts ``` ### Request ###### Request headers ``` Authorization: Bearer Content-Type: application/vnd.api+json x-api-key: Accept-Encoding: gzip ``` - **Authorization**: This header is used to authenticate your request. You need to replace `<your_bearer_token>` with the actual token you generate. - **Content-Type**: This header tells the server that the request body format is `json:api`. Even though this specific call has no request body, the API requires this header. - **x-api-key**: This is a custom header required by the Trellix API for authentication. You'll need to replace `<your_api_key>` with the key from your onboarding email or the [API Access Management](https://developer.manage.trellix.com/public) page. - **Accept-Encoding**: This is an optional header you can include to tell the server you can accept a compressed response (using gzip), which can make the data transfer faster. ###### Request parameters | Parameters | Data type/Values | Description | | --- | --- | --- | | sort | string | Specifies the order (ascending/descending) for the returned results. | | from | integer | Sets the start of the time frame to search, in epoch milliseconds. | | to | integer | Sets the end of the time frame to search, in epoch milliseconds. | | page[offset] | integer | Skips a specified number of records; used for pagination. | | page[limit] | integer | Sets the maximum number of records to return per page. | ### Response ###### Response parameters | Parametrs | Data Type | Description | | --- | --- | --- | | detectionsCount | integer | Total number of threat detections flagged on this host. | | severity | string (enum: s0–s5) | Highest aggregated severity level currently affecting the host. For details, see [Security levels](/v1/docs/severity-levels-2). | | rank | integer | Priority ranking of this host relative to other affected entities. | | firstDetected | string (date-time) | Timestamp of when the first malicious activity was detected on this host. | | host.aGuid | string | The Agent GUID uniquely identifies the device. | | host.hostname | string | Host name of the device. | | host.epoTags | array[string] | List of ePO tags associated with the host. | | host.os.desc / major / minor / build / sp | string / integer | OS description, major/minor version, build number, service pack. | | host.netInterfaces | array[object] | Network interfaces such as name, macAddress, ip, type. | | host.lastBootTime | string (date-time) | Last boot time of the host. | | host.traceExtendedVisibility | integer | Bitmask — each set bit indicates a trace rule enabled for extended visibility. | | host.hostOs | string | Operating system string description. | ###### Response example ``` {  "jsonapi": {    "version": "1.0"  },  "meta": {    "totalResourceCount": 1  },  "data": [    {      "type": "affected-hosts",      "id": "649889",      "attributes": {        "detectionsCount": 1,        "severity": "s4",        "rank": 270,        "firstDetected": "2023-08-27T05:34:29Z",        "host": {          "os": {},          "netInterfaces": [],          "traceExtendedVisibility": 0,          "hostOs": "",          "aGuid": "6D0A37A8-B5B7-4414-9444-A2B17721642B"        }      }    }  ],  "links": {    "self": "/edr/v2/threats/182612/affectedhosts?page[offset]=0&page[limit]=20",    "first": "/edr/v2/threats/182612/affectedhosts?page[offset]=0&page[limit]=20",    "prev": "/edr/v2/threats/182612/affectedhosts?page[offset]=0&page[limit]=20",    "next": "/edr/v2/threats/182612/affectedhosts?page[offset]=0&page[limit]=20",    "last": "/edr/v2/threats/182612/affectedhosts?page[offset]=0&page[limit]=20"  } } ``` ### Response codes | Status | Response | Description | | --- | --- | --- | | 200 | OK | Your request was processed successfully. The server has returned the requested data. | | 400 | Bad request | The server couldn't understand your request, likely due to a syntax error or an invalid parameter. | | 401 | Access denied request | Your request was rejected because it lacks valid authentication credentials. Check your API key and token. | | 403 | Forbidden | You are not authorized to access this resource. While your credentials may be valid, you don't have the necessary permissions. | | 404 | Not Found | The specific resource or endpoint you requested does not exist. | | 415 | Unsupported Media Type | The server rejected your request because the data format `(Content-Type)` is not supported. | | 429 | Too Many Requests | You've exceeded the rate limit by sending too many requests in a short period. The `Retry-After` header in the response will tell you how long to wait before trying again. | | 500 | Internal Server Error | Something went wrong on the server's end. This is not an issue with your request. |