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

Return a list of groups.

## Basic Parameters

<div className="integrations-table">
  | Parameter | Description                                                                                                                                                                                                                             |
  | --------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | Filters   | Filter groups by specifying the field ID to filter by, and a list of values to include.<br /><br />Example:<br /><pre><code>\[<br />  \{<br />    "id": "name",<br />    "includeValues": \["Group\_Name"]<br />  }<br />]</code></pre> |
  | Limit     | Limit the returned number of results.                                                                                                                                                                                                   |
  | Offset    | Use this to paginate through results. Insert the `nextOffset` value from the previous response to retrieve the next batch of results.                                                                                                   |
</div>

## Advanced Parameters

<div className="integrations-table">
  | Parameter | Description                                   |
  | --------- | --------------------------------------------- |
  | Search    | A free-text query used to search for results. |
</div>

## Example Output

```json theme={"dark"}
{
	"items": [
		{
			"id": "<string>",
			"name": "<string>",
			"domain": "<string>",
			"hasNetworkProtectionPolicy": false,
			"hasIdentityProtectionPolicy": false,
			"guid": "<string>",
			"sid": "<string>",
			"createdAt": 2493739038892,
			"updatedAt": 3283357404594,
			"role": 4,
			"description": "<string>",
			"directMembersCount": 0,
			"principalName": "<string>",
			"type": "<string>",
			"externalId": "<string>"
		}
	],
	"nextOffset": 2
}
```

## Workflow Library Example

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