> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blinkops.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Alert

Retrieve a filtered list of alerts.

<Note>
  External Documentation

  To learn more, visit the [Panther documentation](https://docs.panther.com/panther-developer-workflows/api/rest/alerts#get-alerts).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                |
  | ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
  | Assignee         | Filter alerts by the assignee by its ID.                                                                                   |
  | Created After    | The timeframe after which alerts were created. When omitted, defaults to 30 days ago.                                      |
  | Created Before   | The timeframe before which alerts were created. When omitted, defaults to current time.                                    |
  | Cursor           | A token used to specify a results page. This value can be obtained from the `endCursor` property from a previous response. |
  | Detection ID     | Filter alerts by the detection ID.                                                                                         |
  | Limit            | The maximum number of results to return in the response. Valid range is `1`-`50`.                                          |
  | Name             | Filter alerts by name, entering a partial or full string.                                                                  |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                           |
  | Severity         | Filter alerts by the severity.                                                                                             |
  | Sort Direction   | The sort direction of the results.                                                                                         |
  | Status           | Filter alerts by the status.                                                                                               |
  | Sub Type         | Filter alerts by the sub-type of the alert.                                                                                |
  | Type             | Filter alerts by the type of the alert.                                                                                    |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter      | Description                                                               |
  | -------------- | ------------------------------------------------------------------------- |
  | Log Source     | A comma-separated list of log sources of alerts to filter the results by. |
  | Log Type       | A comma-separated list of log types to filter the results by.             |
  | Maximum events | Filter alerts by the maximum number of events in each retrieved alert.    |
  | Minimum events | Filter alerts by the minimum number of events in each retrieved alert.    |
  | Resource Type  | A comma-separated list of resource types to filter the results by.        |
</div>

## Example Output

```json theme={"dark"}
{
	"next": "text",
	"results": [
		{
			"assignee": {
				"id": "user",
				"type": "text"
			},
			"context": null,
			"createdAt": "text",
			"deliveries": [
				{
					"dispatchedAt": "text",
					"label": "text",
					"message": "text",
					"outputId": "text",
					"statusCode": 1,
					"success": true
				}
			],
			"detection": {
				"id": "text",
				"type": "RULE"
			},
			"eventCount": 1,
			"firstEventOccurredAt": "text",
			"id": "text",
			"lastReceivedEventAt": "text",
			"runbook": "text",
			"severity": "CRITICAL",
			"status": "OPEN",
			"systemError": {
				"detection": {
					"id": "text",
					"type": "RULE"
				},
				"sourceId": "text",
				"sourceType": "text",
				"type": "text"
			},
			"title": "text",
			"type": "text",
			"updatedBy": {
				"id": "user",
				"type": "text"
			}
		}
	]
}
```

## Workflow Library Example

[List Alert with Panther and Send Results Via Email](https://library.blinkops.com/workflows/list-alert-with-panther-and-send-results-via-email)

<div className="iframe-wrapper">
  <div className="iframe-media">
    <img src="https://mintcdn.com/blinkops-2/ojHYuDeYX5FWuN8a/img/Icons/play-box.svg?fit=max&auto=format&n=ojHYuDeYX5FWuN8a&q=85&s=b8af968e71438a9499c3223c9bd29fb2" alt="Workflow Library" width="16" height="16" data-path="img/Icons/play-box.svg" />

    Preview this Workflow on desktop
  </div>

  <iframe className="iframe" src="https://library.blinkops.com/workflows/list-alert-with-panther-and-send-results-via-email/canvas" />
</div>