---
title: "GET /user/{userId}/permission-groups#maxResults"
method: GET
path: "/user/{userId}/permission-groups#maxResults"
---

# GET /user/{userId}/permission-groups#maxResults

`GET /user/{userId}/permission-groups#maxResults`

Lists all the permission groups that are associated with a specific user account.

## Path parameters

- `userId` string, required

## Query parameters

- `nextToken` string
- `maxResults` integer, required

## Response `200`

Success

- ListPermissionGroupsByUserResponse
  - `permissionGroups` PermissionGroupByUser[] — A list of returned permission groups.
    - `permissionGroupId` string — The unique identifier for the permission group.
    - `name` string, password — The name of the permission group.
    - `membershipStatus` 'ADDITION_IN_PROGRESS' | 'ADDITION_SUCCESS' | 'REMOVAL_IN_PROGRESS' — <p>Indicates the status of the user account within a permission group.</p> <ul> <li> <p> <code>ADDITION_IN_PROGRESS</code> – The user account is currently being added to the permission group.</p> </li> <li> <p> <code>ADDITION_SUCCESS</code> – The user account is successfully added to the permission group.</p> </li> <li> <p> <code>REMOVAL_IN_PROGRESS</code> – The user is currently being removed from the permission group.</p> </li> </ul>
  - `nextToken` string — A token that indicates where a results page should begin.

## Other responses

- `480` — InternalServerException
- `481` — ValidationException
- `482` — ThrottlingException
- `483` — AccessDeniedException
- `484` — ResourceNotFoundException

---

[API](https://skmtc.net/aws/apis/finspace-data.md) · [All operations](https://skmtc.net/aws/apis/finspace-data/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/finspace-data/revisions/d7561d153837/schema)