---
title: "Alert details request"
slug: "alert-details-request"
tags: ["Reference"]
updated: 2026-08-20T06:49:47Z
published: 2026-09-03T18:40:54Z
canonical: "docs.trellix.com/alert-details-request"
---
> ## 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.
# Alert details request
Gets details for a single alert.
```
GET https://
/wsapis/[v1.2.0|v2.0.0]/alerts/alert/
```
Availability
This command is available on the following appliances:
- Central Management System
- Malware Analysis
- Email Security — Server
- File Protect
- Network Security
Required headers:
```
X-FeApi-Token: [API-Token]
X-FeClient-Token: [Client-Token]
Accept: application/xml
```
### Parameters
- `address`—The IP address of the appliance running the Web Services API.
- `alert_ID`—The infection ID. You must also specify the Alert-Type.
- API-Token—This token authenticates the session. By default, the session times out after 15 minutes of inactivity.
- Client-Token—(Optional) This client token is provided by Trellix. For more information about the client token, contact your sales representative.
### Example request
```
GET https://xxx.xxx.xxx.xxx:443/wsapis/v1.2.0/alerts/alert/4790
```
Request headers:
```
X-FeApi-Token: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
X-FeClient-Token: BigDataInc
Accept: application/json
```
### Alert details response
```
HTTP/1.1 [Response Code] [Response Message]
Date: [Date]
HTTP/1.1 200 OK
Date: Tue, 14 May 2019 22:17:56 GMT
Content-Type: application/xml
5e747bddd6a759b0a591ab4bb3b5254b
cfbb1006d9e6c2660b4876fecef9789c1a3ac0c807181277a2778c59d9b8675f
testuser1@aedev.com
https://camelback-sunil-ex.eng.fireeye.com/emps/eanalysis?e_id=5116&type=attch
blocked
2019-05-14T20:53:44.722Z
testuser2@aedev.com
Test Email
```
### Response fields
- Response Code—A standard HTML response code.
- 200—Request successful.
- 4xx—Request unsuccessful because unknown or invalid fields were included in the input.
- 5xx—Request unsuccessful because the server encountered a problem.
- Response Message—A standard HTML response message.
- Empty—Request successful.
- Invalid Client Request—Request unsuccessful because unknown or invalid fields were included in the input.
- Server encountered a problem...retry later—Request unsuccessful because the server encountered a problem.
- Date—Standard HTML date format.
- alert fields—The fields returned vary depending on the alert. See the *Alert Notifications* reference guide for descriptions of available fields.
### Example response
```
HTTP/1.1 200 OK
Date: Tue, 14 May 2019 22:17:56 GMT
Content-Type: application/xml
5e747bddd6a759b0a591ab4bb3b5254b
cfbb1006d9e6c2660b4876fecef9789c1a3ac0c807181277a2778c59d9b8675f
testuser1@aedev.com
https://test39-ex.eng.fireeye.com/emps/eanalysis?e_id=5116&type=attch
blocked
2019-05-14T20:53:44.722Z
testuser2@aedev.com
Test Email
```
: