---
title: "List user's groups"
method: GET
path: "/users/{user_id}/memberships"
tags: ["Group memberships"]
---

# List user's groups

`GET /users/{user_id}/memberships`

Retrieves all the groups for a user. Only members of this
group or users with admin-level permissions will be able to
use this API.

## Path parameters

- `user_id` string, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

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

- GroupMemberships — 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` GroupMembership[] — A list of group memberships.
    - `id` string — The unique identifier for this group membership.
    - `type` 'group_membership' — The value will always be `group_membership`.
    - `user` object — The user that the membership applies to.
      - `id` string, required — The unique identifier for this user.
      - `type` 'user', required — The value will always be `user`.
      - `name` string — The display name of this user.
      - `login` string, email — The primary email address of this user.
    - `group` object — The group that the membership applies to.
      - `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.
    - `role` 'member' | 'admin' — The role of the user in the group.
    - `created_at` string, date-time — The time this membership was created.
    - `modified_at` string, date-time — The time this membership was last modified.

## 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/versions/ba8f087e1a4d/schema)