---
title: "List groups for enterprise"
method: GET
path: "/groups"
tags: ["Groups"]
---

# List groups for enterprise

`GET /groups`

Retrieves all of the groups for a given enterprise. The user
must have admin permissions to inspect enterprise's groups.

## Query parameters

- `filter_term` string
- `fields` string[]
- `limit` integer
- `offset` integer

## Response `200`

Returns a collection of group objects. If there are no groups, an
empty collection will be returned.

- Groups — The part of an API response that describes pagination.
  - `total_count` integer — One greater than the offset of the last entry in the entire collection. The total number of entries in the collection may be less than `total_count`. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
  - `limit` integer — The limit that was used for these entries. This will be the same as the `limit` query parameter unless that value exceeded the maximum value allowed. The maximum value varies by API.
  - `offset` integer — The 0-based offset of the first entry in this set. This will be the same as the `offset` query parameter. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
  - `order` object[] — The order by which items are returned. This field is only returned for calls that use offset-based pagination. For marker-based paginated APIs, this field will be omitted.
    - `by` string — The field to order by.
    - `direction` 'ASC' | 'DESC' — The direction to order by, either ascending or descending.
  - `entries` GroupFull[] — A list of groups.
    - `id` string, required — The unique identifier for this object.
    - `type` 'group', required — The value will always be `group`.
    - `name` string — The name of the group.
    - `group_type` 'managed_group' | 'all_users_group' — The type of the group.
    - `created_at` string, date-time — When the group object was created.
    - `modified_at` string, date-time — When the group object was last modified.
    - `provenance` string — Keeps track of which external source this group is coming from (e.g. "Active Directory", "Google Groups", "Facebook Groups"). Setting this will also prevent Box users from editing the group name and its members directly via the Box web application. This is desirable for one-way syncing of groups.
    - `external_sync_identifier` string — An arbitrary identifier that can be used by external group sync tools to link this Box Group to an external group. Example values of this field could be an Active Directory Object ID or a Google Group ID. We recommend you use of this field in order to avoid issues when group names are updated in either Box or external systems.
    - `description` string — Human readable description of the group.
    - `invitability_level` 'admins_only' | 'admins_and_members' | 'all_managed_users' — Specifies who can invite the group to collaborate on items. When set to `admins_only` the enterprise admin, co-admins, and the group's admin can invite the group. When set to `admins_and_members` all the admins listed above and group members can invite the group. When set to `all_managed_users` all managed users in the enterprise can invite the group.
    - `member_viewability_level` 'admins_only' | 'admins_and_members' | 'all_managed_users' — Specifies who can view the members of the group (Get Memberships for Group). * `admins_only` - the enterprise admin, co-admins, group's group admin. * `admins_and_members` - all admins and group members. * `all_managed_users` - all managed users in the enterprise.
    - `permissions` object — Describes the permissions that the current user has for this group.
      - `can_invite_as_collaborator` boolean — Specifies if the user can invite the group to collaborate on any items.

## Other responses

- `default` — An unexpected client error.

---

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