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

Get all user groups accessible to the current user.

**Note**: Groups on the same level as your user or lower in the vault hierarchy are retrieved.

**Required Permissions for using this action**:

* `Audit users`

<Note>
  External Documentation

  To learn more, visit the [CyberArk documentation](https://docs.cyberark.com/pam-self-hosted/latest/en/content/webservices/getgroupsfromvault.htm).
</Note>

## Parameters

<div className="integrations-table">
  | Parameter       | Description                                                                                                                                                                                                                                                                                                                                                                |
  | --------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Filter          | Filter group records by group type and name using standard REST query format.<br /><br />**Available fields to search by**:<br />- `groupType` - Group type (Directory or Vault)<br />- `groupName` - Group name<br /><br />Examples:<br />- `groupType eq Directory` - Show only directory groups.<br />- `groupName eq Auditors` - Find groups named exactly "Auditors". |
  | Include Members | Select to include group members in the response.                                                                                                                                                                                                                                                                                                                           |
  | Search          | Filter records by properties that contain the specified search text.                                                                                                                                                                                                                                                                                                       |
  | Sort            | The property by which to sort the retrieved results.                                                                                                                                                                                                                                                                                                                       |
</div>

## Example Output

```json theme={"dark"}
{
	"value": [
		{
			"id": 8,
			"groupType": "Vault",
			"members": [
				{
					"UserName": "Auditor",
					"id": 3
				}
			],
			"groupName": "Auditors",
			"description": "Auditors group",
			"location": "\\"
		}
	],
	"count": 1
}
```

## Workflow Library Example

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