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

Get a list of detections with optional filtering.

<Note>
  External Documentation

  To learn more, visit the [Living Security documentation](https://docs.api.livingsecurity.com/reference/list_detections_v1_detections__get).
</Note>

## Basic Parameters

<div className="integrations-table">
  | Parameter        | Description                                                                                                                                                                                                |
  | ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Active           | Select to include only active detections.                                                                                                                                                                  |
  | Cursor           | Pagination cursor returned from a previous request. If this value is provided, results continue from the last cursor and any other specified search attributes or terms will be ignored.                   |
  | Department       | Filter results by the department associated with the detection.                                                                                                                                            |
  | Detection ID     | Filter results by the detection's ID.                                                                                                                                                                      |
  | Page             | The page to show results from, defaults to `1`.                                                                                                                                                            |
  | Page Size        | The maximum number of results to return, defaults to `20`.                                                                                                                                                 |
  | Return All Pages | Automatically fetch all resources, page by page.                                                                                                                                                           |
  | Sort             | A comma-separated array of sorting criteria in `field\|direction` format (e.g. `fieldA\|desc,fieldB`).<br /><br />Defaults to `detected_at\|desc`. When the direction is not specified, defaults to `asc`. |
  | Title            | Filter results by the detection's title.                                                                                                                                                                   |
  | Verified         | Select to include only verified detections.                                                                                                                                                                |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter                  | Description                                                          |
  | -------------------------- | -------------------------------------------------------------------- |
  | Business Unit              | Filter results by the business unit associated with the detection.   |
  | City                       | Filter results by the city associated with the detection.            |
  | Country                    | Filter results by the country associated with the detection.         |
  | Custom Attribute 1         | Filter results by a custom attribute.                                |
  | Custom Attribute 10        | Filter results by a custom attribute.                                |
  | Custom Attribute 2         | Filter results by a custom attribute.                                |
  | Custom Attribute 3         | Filter results by a custom attribute.                                |
  | Custom Attribute 4         | Filter results by a custom attribute.                                |
  | Custom Attribute 5         | Filter results by a custom attribute.                                |
  | Custom Attribute 6         | Filter results by a custom attribute.                                |
  | Custom Attribute 7         | Filter results by a custom attribute.                                |
  | Custom Attribute 8         | Filter results by a custom attribute.                                |
  | Custom Attribute 9         | Filter results by a custom attribute.                                |
  | Date                       | Filter results by the detection's date.                              |
  | Detected At                | Filter results by the timestamp when the detection occurred.         |
  | Employee Level             | Filter results by the employee level.                                |
  | Employee Type              | Filter results by the employee type.                                 |
  | Employee Work Status       | Filter results by the employee work status.                          |
  | First Name                 | Filter results by the first name.                                    |
  | Key                        | Filter results by the key of the detection.                          |
  | Last Name                  | Filter results by the last name.                                     |
  | Living Security User Email | Filter results by the user's email in Living Security.               |
  | Office Location            | Filter results by the office location associated with the detection. |
  | Organization               | Filter results by the organization associated with the detection.    |
  | Region                     | Filter results by the region associated with the detection.          |
</div>

## Example Output

```json theme={"dark"}
{
	"data": [
		{
			"id": "string",
			"identity": {
				"id": "string",
				"key": "string"
			},
			"insight": {
				"name": "string",
				"id": "string"
			},
			"date": "2025-04-29",
			"detected_at": "2025-04-29T06:14:41.434Z"
		}
	],
	"meta": {
		"total": 0,
		"returned": 0,
		"pagination": {
			"page_size": 0,
			"page": 0,
			"next": "string"
		}
	}
}
```

## Workflow Library Example

[List Detections with Living Security and Send Results Via Email](https://library.blinkops.com/workflows/list-detections-with-living-security-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-detections-with-living-security-and-send-results-via-email/canvas" />
</div>