Skip to main content
Retrieve a list of alerts with optional filtering.
External DocumentationTo learn more, visit the FireHydrant documentation.

​
Basic Parameters

ParameterDescription
PageThe page number to show results from.
Per PageMaximum number of results to return.
QueryA query for filtering the alerts by.
StatusesFilter the alerts by the status of the alerts.
TeamsA 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.
UsersA comma-separated list of user IDs to filter alerts by.

Note: This currently only works for Signals alerts.

​
Advanced Parameters

ParameterDescription
EnvironmentsA comma-separated list of environment IDs to filter alerts by.

Note: This currently only works for Signals alerts.
FunctionalitiesA comma-separated list of functionality IDs to filter alerts by.

Note: This currently only works for Signals alerts.
ServicesA comma-separated list of service IDs to filter alerts by.

Note: This currently only works for Signals alerts.
Signal RulesA comma-separated list of signals rule IDs to filter alerts by.

Note: This currently only works for Signals alerts.
Tag Match StrategyDefine 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.
TagsA comma-separated list of tags to filter alerts by.

Note: This currently only works for Signals alerts.

​
Example Output

{
	"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
Workflow LibraryPreview this Workflow on desktop