Skip to main content
Get a list of detections with optional filtering.
External DocumentationTo learn more, visit the Living Security documentation.

​
Basic Parameters

ParameterDescription
ActiveSelect to include only active detections.
CursorPagination 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.
DepartmentFilter results by the department associated with the detection.
Detection IDFilter results by the detection’s ID.
PageThe page to show results from, defaults to 1.
Page SizeThe maximum number of results to return, defaults to 20.
Return All PagesAutomatically fetch all resources, page by page.
SortA 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.
TitleFilter results by the detection’s title.
VerifiedSelect to include only verified detections.

​
Advanced Parameters

ParameterDescription
Business UnitFilter results by the business unit associated with the detection.
CityFilter results by the city associated with the detection.
CountryFilter results by the country associated with the detection.
Custom Attribute 1Filter results by a custom attribute.
Custom Attribute 10Filter results by a custom attribute.
Custom Attribute 2Filter results by a custom attribute.
Custom Attribute 3Filter results by a custom attribute.
Custom Attribute 4Filter results by a custom attribute.
Custom Attribute 5Filter results by a custom attribute.
Custom Attribute 6Filter results by a custom attribute.
Custom Attribute 7Filter results by a custom attribute.
Custom Attribute 8Filter results by a custom attribute.
Custom Attribute 9Filter results by a custom attribute.
DateFilter results by the detection’s date.
Detected AtFilter results by the timestamp when the detection occurred.
Employee LevelFilter results by the employee level.
Employee TypeFilter results by the employee type.
Employee Work StatusFilter results by the employee work status.
First NameFilter results by the first name.
KeyFilter results by the key of the detection.
Last NameFilter results by the last name.
Living Security User EmailFilter results by the user’s email in Living Security.
Office LocationFilter results by the office location associated with the detection.
OrganizationFilter results by the organization associated with the detection.
RegionFilter 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
Workflow LibraryPreview this Workflow on desktop
⌘I