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

# Find Groups

List and query groups in a tenant.

Application permission required: `Directories | Groups | Edit`.

> [!NOTE]
>
> External Documentation
>
> To learn more, visit the [Mimecast documentation](https://developer.services.mimecast.com/docs/userandgroupmanagement/1/routes/api/directory/find-groups/post).

## Parameters

| Parameter | Description |
| - | - |
| Page Size | The number of results to request. |
| Page Token | The value of the 'next' or 'previous' fields from an earlier request. |
| Query | A string to query for. |
| Source | A group source to filter on. `default_value: cloud` |

## Example Output

```json theme={"dark"}
{
  "meta": {
    "status": 200,
    "pagination": {
      "pageSize": 25,
      "recordStart": 0,
      "next": "eNqrVipOTS4tSs.....",
      "previous": "eNqrVipOTS4tSs....."
  },
  "data": [
    {
      "folders": [
        {
          "description": "String",
          "source": "String",
          "folderCount": 0,
          "parentId": "String",
          "id": "String",
          "userCount": 10
        }
      ],
      "source": "String",
      "query": "String"
    }
  ]
}
```
