---
title: "GET /api/permissions/group"
method: GET
path: "/api/permissions/group"
tags: ["/api/permissions"]
---

# GET /api/permissions/group

`GET /api/permissions/group`

Fetch all `PermissionsGroups`, including a count of the number of `:members` in that group.
  This API requires superuser or group manager of more than one group.
  Group manager is only available if `advanced-permissions` is enabled and returns only groups that user
  is manager of.

  Optional query parameter `tenancy` can be used to filter groups:
  - `tenancy=external`: Returns only tenant groups (where `is_tenant_group = true`)
  - `tenancy=internal`: Returns only non-tenant groups (where `is_tenant_group = false`)
  - No `tenancy` parameter: Returns all groups (default behavior)

## Query parameters

- `tenancy` 'external' | 'internal'

## Response `2XX`

Successful response

## Other responses

- `4XX` — Client error response
- `5XX` — Server error response

---

[API](https://skmtc.net/metabase/apis/metabase-api.md) · [All operations](https://skmtc.net/metabase/apis/metabase-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/metabase/metabase-api/revisions/08b5a2bafb4f/schema)