External DocumentationTo learn more, visit the Living Security documentation.
Basic Parameters
| 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).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. |
Advanced Parameters
| 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. |
Example Output
{
"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