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

## Basic Parameters

| 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. **Note**: This currently only works for `Signals` alerts. |
| Users | A comma-separated list of user IDs to filter alerts by. **Note**: This currently only works for `Signals` alerts. |

## Advanced Parameters

| Parameter | Description |
| - | - |
| Environments | A comma-separated list of environment IDs to filter alerts by.  **Note**: This currently only works for `Signals` alerts. |
| Functionalities | A comma-separated list of functionality IDs to filter alerts by. **Note**: This currently only works for `Signals` alerts. |
| Services | A comma-separated list of service IDs to filter alerts by. **Note**: This currently only works for `Signals` alerts. |
| Signal Rules | A comma-separated list of signals rule IDs to filter alerts by. **Note**: This currently only works for `Signals` alerts. |
| Tag Match Strategy | Define how tags should be matched when filtering alerts. - `any`: Return alerts that contain **at least one** of the specified tags. - `match_all`: Return alerts that contain **all** of the specified tags. - `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. **Note**: This currently only works for `Signals` alerts. |

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