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

Returns list of alerts.

<Note>
  External Documentation

  To learn more, visit the [Opsgenie documentation](https://www.opsgenie.com/docs/alert-api#section-list-alerts).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter      | Description                                                                                                                                                                                                                                                                                |
  | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
  | Limit          | Maximum number of items to provide in the result. Must be a positive integer value. Default value is 20 and maximum value is 100.                                                                                                                                                          |
  | Offset         | Start index of the result set (to apply pagination). Minimum value (and also default value) is 0.                                                                                                                                                                                          |
  | Order          | Sorting order of the result set.                                                                                                                                                                                                                                                           |
  | Query          | Search query to apply while filtering the alerts. You can use field:value combination with most alert fields. For more information visit [https://support.atlassian.com/opsgenie/docs/search-queries-for-alerts/](https://support.atlassian.com/opsgenie/docs/search-queries-for-alerts/). |
  | Search ID      | Identifier of the saved search query to apply while filtering the alerts.                                                                                                                                                                                                                  |
  | Search ID type | Identifier type of the saved search query. Possible values are 'id', or 'name'.                                                                                                                                                                                                            |
  | Sort           | Name of the field that result set will be sorted by.                                                                                                                                                                                                                                       |
</div>

## Example Output

```json theme={"dark"}
{
	"data": [
		{
			"acknowledged": false,
			"alias": "string",
			"count": 0,
			"createdAt": "date-time",
			"id": "string",
			"integration": {
				"id": "string",
				"name": "string",
				"type": "string"
			},
			"isSeen": false,
			"lastOccurredAt": "date-time",
			"message": "string",
			"owner": "string",
			"priority": "string",
			"report": {
				"ackTime": 0,
				"acknowledgedBy": "string",
				"closeTime": 0,
				"closedBy": "string"
			},
			"responders": [
				{
					"id": "string",
					"type": "string"
				}
			],
			"snoozed": false,
			"snoozedUntil": "date-time",
			"source": "string",
			"status": "string",
			"tags": [
				"string"
			],
			"tinyId": "string",
			"updatedAt": "date-time"
		}
	],
	"paging": {
		"first": "string",
		"last": "string",
		"next": "string",
		"prev": "string"
	},
	"requestId": "string",
	"took": 0
}
```

## Workflow Library Example

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