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

Retrieve a list of alerts with optional filtering.

<Note>
  External Documentation

  To learn more, visit the [FireHydrant documentation](https://docs.firehydrant.com/reference/list_alerts).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                                                             |
  | --------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Page      | The page number to show results from.                                                                                                                                   |
  | Per Page  | Maximum number of results to return.                                                                                                                                    |
  | Query     | A query for filtering the alerts by.                                                                                                                                    |
  | Statuses  | Filter the alerts by the status of the alerts.                                                                                                                          |
  | Teams     | A comma-separated list of team IDs to filter alerts by. Can be obtained using `List Teams` action.<br /><br />**Note**: This currently only works for `Signals` alerts. |
  | Users     | A comma-separated list of user IDs to filter alerts by.<br /><br />**Note**: This currently only works for `Signals` alerts.                                            |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter          | Description                                                                                                                                                                                                                                                                                                                               |
  | ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Environments       | A comma-separated list of environment IDs to filter alerts by.<br /><br /> **Note**: This currently only works for `Signals` alerts.                                                                                                                                                                                                      |
  | Functionalities    | A comma-separated list of functionality IDs to filter alerts by.<br /><br />**Note**: This currently only works for `Signals` alerts.                                                                                                                                                                                                     |
  | Services           | A comma-separated list of service IDs to filter alerts by.<br /><br />**Note**: This currently only works for `Signals` alerts.                                                                                                                                                                                                           |
  | Signal Rules       | A comma-separated list of signals rule IDs to filter alerts by.<br /><br />**Note**: This currently only works for `Signals` alerts.                                                                                                                                                                                                      |
  | Tag Match Strategy | Define how tags should be matched when filtering alerts.<br /><br />- `any`: Return alerts that contain **at least one** of the specified tags.<br />- `match_all`: Return alerts that contain **all** of the specified tags.<br />- `exclude`: Return alerts that contain **none** of the specified tags.have none of the supplied tags. |
  | Tags               | A comma-separated list of tags to filter alerts by.<br /><br />**Note**: This currently only works for `Signals` alerts.                                                                                                                                                                                                                  |
</div>

## Example Output

```json theme={"dark"}
{
	"data": [
		{
			"id": "string",
			"summary": "string",
			"description": "string",
			"priority": "string",
			"integration_name": "string",
			"starts_at": "2025-07-16T07:10:06.887Z",
			"ends_at": "2025-07-16T07:10:06.887Z",
			"duration_ms": 0,
			"duration_iso8601": "string",
			"status": "string",
			"remote_id": "string",
			"remote_url": "string",
			"labels": {},
			"environments": [
				{
					"id": "string",
					"name": "string"
				}
			],
			"services": [
				{
					"id": "string",
					"name": "string"
				}
			],
			"tags": [
				"string"
			],
			"source_icon": "string",
			"signal_id": "string",
			"signal_rule": {
				"id": "string",
				"name": "string",
				"expression": "string",
				"team_id": "string",
				"target": {
					"id": "string",
					"name": "string",
					"type": "string",
					"is_pageable": true
				},
				"created_by": {
					"id": "string",
					"name": "string",
					"source": "string",
					"email": "string"
				},
				"created_at": "2025-07-16T07:10:06.887Z",
				"updated_at": "2025-07-16T07:10:06.887Z",
				"incident_type": {
					"id": "string",
					"name": "string"
				},
				"notification_priority_override": "HIGH",
				"create_incident_condition_when": "WHEN_UNSPECIFIED",
				"deduplication_expiry": "PT1H"
			},
			"signal_target": {
				"id": "string",
				"name": "string",
				"type": "string",
				"is_pageable": true
			},
			"team_name": "string",
			"team_id": "string",
			"position": 0,
			"incidents": [
				{
					"id": "string",
					"name": "string",
					"number": 0
				}
			],
			"events": [
				{
					"id": "string",
					"type": "string",
					"data": {},
					"created_at": "2025-07-16T07:10:06.887Z"
				}
			],
			"is_expired": true,
			"is_noise": true,
			"parent_alerts": [
				{
					"id": "string",
					"summary": "string",
					"description": "string",
					"starts_at": "2025-07-16T07:10:06.887Z",
					"ends_at": "2025-07-16T07:10:06.887Z",
					"status": "string",
					"remote_id": "string",
					"remote_url": "string",
					"labels": {},
					"tags": [
						"string"
					],
					"signal_id": "string",
					"signal_rule": {
						"id": "string",
						"name": "string",
						"expression": "string",
						"team_id": "string",
						"target": {
							"id": "string",
							"name": "string",
							"type": "string",
							"is_pageable": true
						},
						"created_by": {
							"id": "string",
							"name": "string",
							"source": "string",
							"email": "string"
						},
						"created_at": "2025-07-16T07:10:06.887Z",
						"updated_at": "2025-07-16T07:10:06.887Z",
						"incident_type": {
							"id": "string",
							"name": "string"
						},
						"notification_priority_override": "HIGH",
						"create_incident_condition_when": "WHEN_UNSPECIFIED",
						"deduplication_expiry": "PT1H"
					}
				}
			],
			"child_alerts": [
				{
					"id": "string",
					"summary": "string",
					"description": "string",
					"starts_at": "2025-07-16T07:10:06.887Z",
					"ends_at": "2025-07-16T07:10:06.887Z",
					"status": "string",
					"remote_id": "string",
					"remote_url": "string",
					"labels": {},
					"tags": [
						"string"
					],
					"signal_id": "string",
					"signal_rule": {
						"id": "string",
						"name": "string",
						"expression": "string",
						"team_id": "string",
						"target": {
							"id": "string",
							"name": "string",
							"type": "string",
							"is_pageable": true
						},
						"created_by": {
							"id": "string",
							"name": "string",
							"source": "string",
							"email": "string"
						},
						"created_at": "2025-07-16T07:10:06.887Z",
						"updated_at": "2025-07-16T07:10:06.887Z",
						"incident_type": {
							"id": "string",
							"name": "string"
						},
						"notification_priority_override": "HIGH",
						"create_incident_condition_when": "WHEN_UNSPECIFIED",
						"deduplication_expiry": "PT1H"
					}
				}
			],
			"conversations": [
				{
					"id": "string",
					"resource_class": "string",
					"resource_id": "string",
					"field": "string",
					"comments_url": "string",
					"channel": {
						"name": "string"
					}
				}
			]
		}
	],
	"pagination": {
		"count": 0,
		"page": 0,
		"items": 0,
		"pages": 0,
		"last": 0,
		"prev": 0,
		"next": 0
	}
}
```

## Workflow Library Example

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