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

Retrieves a list of investigations.

<Note>
  External Documentation

  To learn more, visit the [Expel documentation](https://workbench.expel.io/api/v2/docs/#section/CRUD-operations/GET-:resource).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                                                                                                                                                                                                                                                                                                                                         |
  | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Filter    | Filters the results based on the given expression. <br /><br />The syntax of a filter expression `filter[<field>]=<operator><value>`.<br /><br />For example: `filter[created_at]=>2020-01-01T00:00:00Z` equals to `created_at > 2020-01-01T00:00:00Z`.<br /><br />For further information regarding filtering resources, please refer to [Expel Documentation](https://workbench.expel.io/api/v2/docs/#section/Common-query-parameters/Filtering). |
  | Limit     | The maximum amount of results to be returned.<br /><br />The `limit` may be set to `0`. This is useful if your api client needs a count of records without needing to retrieve the actual content of those records.                                                                                                                                                                                                                                 |
  | Offset    | The offset of the pagination. Specifies the starting index of the results to be returned.                                                                                                                                                                                                                                                                                                                                                           |
  | Sort      | Sorts the results by a particular attribute.                                                                                                                                                                                                                                                                                                                                                                                                        |
</div>

## Example Output

```json theme={"dark"}
{
	"links": {
		"self": " https://workbench.expel.io/api/v2/investigations"
	},
	"data": [
		{
			"analyst_severity": "CRITICAL",
			"attack_lifecycle": "INITIAL_RECON",
			"attack_timing": "HISTORICAL",
			"attack_vector": "DRIVE_BY",
			"close_comment": "string",
			"created_at": "2019-01-15T15:35:00-05:00",
			"critical_comment": "string",
			"decision": "FALSE_POSITIVE",
			"default_plugin_slug": "string",
			"deleted_at": "2019-01-15T15:35:00-05:00",
			"detection_type": "UNKNOWN",
			"has_hunting_status": true,
			"initial_attack_vector": "string",
			"is_downgrade": true,
			"is_incident": true,
			"is_incident_status_updated_at": "2019-01-15T15:35:00-05:00",
			"is_soc_support_required": true,
			"is_surge": true,
			"last_published_at": "2019-01-15T15:35:00-05:00",
			"last_published_value": "string",
			"lead_description": "string",
			"malware_family": "string",
			"next_steps": "string",
			"open_reason": "ACCESS_KEYS",
			"open_summary": "string",
			"review_requested_at": "2019-01-15T15:35:00-05:00",
			"short_link": "string",
			"source_reason": "HUNTING",
			"status_updated_at": "2019-01-15T15:35:00-05:00",
			"threat_type": "TARGETED",
			"title": "string",
			"updated_at": "2019-01-15T15:35:00-05:00"
		}
	]
}
```

## Workflow Library Example

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