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

​
Basic Parameters

ParameterDescription
ActiveSelect to include only active identities when set to true.
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.
First NameFilter results by the identity’s first name.
Identity IDFilter results by the ID of the identity.
Last NameFilter results by the identity’s last name.
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.

The format of the sort criteria is: field|direction. Direction can be either asc (ascending) or desc (descending) order.

Defaults to last_name|asc. When the direction is not specified, defaults to asc.
VerifiedSelect to include only verified identities when set to true.

​
Advanced Parameters

ParameterDescription
Business UnitFilter results by the identity’s business unit.
CityFilter results by the identity’s city.
CountryFilter results by the identity’s country.
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.
DepartmentFilter results by the identity’s department.
Employee LevelFilter results by the identity’s employee level.
Employee TypeFilter results by the identity’s employee type.
Employee Work StatusFilter results by the identity’s work status.
KeyFilter results by the key of the identity.
Office LocationFilter results by the identity’s office location.
OrganizationFilter results by the identity’s organization.
RegionFilter results by the identity’s region.
TitleFilter results by the title of the identity.

​
Example Output

{
	"data": [
		{
			"id": "string",
			"key": "string",
			"active": true,
			"verified": true,
			"scores": {
				"risk_index": {
					"human_risk_index": 0,
					"updated_at": "2025-04-22T11:43:45.984Z"
				},
				"behavior_score": {
					"behavior_score": 0,
					"updated_at": "2025-04-22T11:43:45.984Z"
				}
			},
			"aliases": [
				{
					"service_id": "string",
					"id": "string",
					"type": "string",
					"value": "string",
					"key": "string"
				}
			],
			"created_at": "2025-04-22T11:43:45.984Z",
			"last_name": "string",
			"first_name": "string",
			"department": "string",
			"title": "string",
			"office_location": "string",
			"business_unit": "string",
			"employee_level": "string",
			"employee_type": "string",
			"employee_work_status": "string",
			"organization": "string",
			"city": "string",
			"region": "string",
			"country": "string",
			"updated_at": "2025-04-22T11:43:45.984Z",
			"custom_attr_001": "string",
			"custom_attr_002": "string",
			"custom_attr_003": "string",
			"custom_attr_004": "string",
			"custom_attr_005": "string",
			"custom_attr_006": "string",
			"custom_attr_007": "string",
			"custom_attr_008": "string",
			"custom_attr_009": "string",
			"custom_attr_010": "string"
		}
	],
	"meta": {
		"total": 0,
		"returned": 0,
		"pagination": {
			"page_size": 0,
			"page": 0,
			"cursor": "string",
			"next": "string"
		}
	}
}

​
Workflow Library Example

List Identities with Living Security and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop