> ## 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 Alerts

List all alerts in your Reco instance.

<Note>
  External Documentation

  To learn more, visit the [Reco documentation](https://recoai.readme.io/reference/policysubsystemfe_listalerts).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter      | Description                                                               |
  | -------------- | ------------------------------------------------------------------------- |
  | Created After  | Return alerts with after the given date and time.                         |
  | Created Before | Return alerts with before the given date and time.                        |
  | Policy ID      | Return alerts with the following policyId.                                |
  | Risk Levels    | Return alerts with these risk types. Returns all risk levels as default.  |
  | Statuses       | Return alerts with the following status. Returns all statuses as default. |
</div>

## Example Output

```json theme={"dark"}
{
	"alerts": [
		{
			"id": "<string>",
			"policyId": "<string>",
			"description": "<string>",
			"aggregationRulesToKeys": {
				"aggregationRuleToKey": [
					{
						"aggregationRule": {
							"aggregationKeyJsonataQuery": "<string>"
						},
						"aggregationKey": {
							"stringKey": "<string>"
						}
					},
					{
						"aggregationRule": {
							"aggregationDuration": "<string>"
						},
						"aggregationKey": {
							"timeKey": "<string>"
						}
					}
				]
			},
			"status": "<string>",
			"riskLevel": "<string>",
			"policyViolations": [
				{
					"id": "<string>",
					"policyId": "<string>",
					"jsonData": "<string>",
					"createdAt": "2025-02-05T19:58:12.037201Z",
					"policyStatusOnViolationCreation": "<string>",
					"policyRiskLevelOnViolationCreation": "<string>",
					"dataSource": "<string>"
				}
			],
			"createdAt": "2025-02-05T19:58:11.581577Z",
			"updatedAt": "2025-02-05T19:58:11.577753Z",
			"extractionSource": "<string>",
			"instanceId": "<string>"
		},
		{
			"id": "<string>",
			"policyId": "<string>",
			"description": "<string>",
			"aggregationRulesToKeys": {
				"aggregationRuleToKey": []
			},
			"status": "<string>",
			"riskLevel": "<string>",
			"policyViolations": [],
			"createdAt": "2025-02-05T19:58:11.581577Z",
			"updatedAt": "2025-02-05T19:58:11.577753Z",
			"extractionSource": "<string>",
			"instanceId": "<string>"
		}
	]
}
```

## Workflow Library Example

[List Alerts with Reco and Send Results Via Email](https://library.blinkops.com/workflows/list-alerts-with-reco-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-alerts-with-reco-and-send-results-via-email/canvas" />
</div>