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

Retrieve a list of incidents.

**Note:** By default, incidents from the last **30 days** are returned. Use the filtering parameters to modify the date range.

<Note>
  External Documentation

  To learn more, visit the [Vega documentation](https://docs.vega.io/api-reference/queries/get-incidents).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                             |
  | ---------------- | ----------------------------------------------------------------------- |
  | Incident IDs     | A comma-separated list of incident IDs to filter by.                    |
  | Incident Names   | A comma-separated list of incident names to filter by.                  |
  | Limit            | The maximum number of results to return per page. The default is `100`. |
  | Offset           | The number of results to skip for pagination.                           |
  | Return All Pages | Automatically fetch all resources, page by page.                        |
  | Severities       | Select the severities to filter by.                                     |
  | Statuses         | Select the statuses to filter by.                                       |
  | Verdicts         | Select the verdicts to filter by.                                       |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter    | Description                                                     |
  | ------------ | --------------------------------------------------------------- |
  | From         | The start date and time to filter results by creation time.     |
  | To           | The end date and time to filter results by creation time.       |
  | Updated From | The start date and time to filter results by last updated time. |
  | Updated To   | The end date and time to filter results by last updated time.   |
</div>

## Example Output

```json theme={"dark"}
{
	"data": {
		"getIncidents": {
			"incidents": [
				{
					"id": "<string>",
					"name": "<string>",
					"createdBy": "<string>",
					"createdAt": "2024-01-15T09:30:00Z",
					"lastUpdated": "2024-01-15T09:30:00Z",
					"severity": "LOW",
					"status": "NEW",
					"dataSources": [
						"<string>"
					],
					"verdict": "NA",
					"verdictReasoning": "<string>",
					"assignees": [
						{
							"userId": "<string>",
							"displayName": "<string>",
							"email": "<string>"
						}
					],
					"comments": [
						{
							"text": "<string>",
							"addedBy": "<string>",
							"addedAt": "2024-01-15T09:30:00Z"
						}
					],
					"incidentSummary": "<string>",
					"incidentFindings": [
						"<string>"
					],
					"assets": [
						"<string>"
					],
					"observables": [
						"<string>"
					],
					"alertsCount": 123,
					"alerts": [
						{
							"alertId": "<string>",
							"name": "<string>",
							"createdAt": "2024-01-15T09:30:00Z"
						}
					],
					"recommendedActions": [
						{
							"name": "<string>",
							"description": "<string>",
							"actionKey": "<string>",
							"targetParams": {}
						}
					],
					"investigationPlan": [
						{
							"stepName": "<string>",
							"stepConclusion": "<string>",
							"cells": [
								{
									"cellName": "<string>",
									"query": "<string>",
									"queryId": "<string>"
								}
							]
						}
					],
					"link": "<string>",
					"assignee": {
						"userId": "<string>",
						"displayName": "<string>",
						"email": "<string>"
					}
				}
			],
			"total": 123,
			"limit": 123,
			"offset": 123,
			"error": {
				"code": "<string>",
				"message": "<string>"
			}
		}
	}
}
```

## Workflow Library Example

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