---
title: "List access groups for a team, project or member"
method: GET
path: "/v1/access-groups"
tags: ["access-groups"]
---

# List access groups for a team, project or member

`GET /v1/access-groups`

List access groups

## Query parameters

- `projectId` string — Filter access groups by project.
- `search` string — Search for access groups by name.
- `membersLimit` integer — Number of members to include in the response.
- `projectsLimit` integer — Number of projects to include in the response.
- `limit` integer — Limit how many access group should be returned.
- `next` string — Continuation cursor to retrieve the next page of results.
- `teamId` string
- `slug` string

## Response `200`

- union
  - object
  - object
    - `accessGroups` object[], required
      - `members` string[]
      - `projects` string[]
      - `entitlements` string[]
      - `teamPermissions` string[]
      - `isDsyncManaged` false | true, required
      - `name` string, required — The name of this access group.
      - `createdAt` string, required — Timestamp in milliseconds when the access group was created.
      - `teamId` string, required — ID of the team that this access group belongs to.
      - `updatedAt` string, required — Timestamp in milliseconds when the access group was last updated.
      - `accessGroupId` string, required — ID of the access group.
      - `membersCount` number, required — Number of members in the access group.
      - `projectsCount` number, required — Number of projects in the access group.
      - `teamRoles` string[] — Roles that the team has in the access group.
    - `pagination` object, required
      - `count` number, required
      - `next` string, nullable, required

## Other responses

- `400` — One of the provided values in the request query is invalid.
- `401` — The request is not authorized.
- `403` — You do not have permission to access this resource.
- `410`

---

[API](https://skmtc.net/vercel/apis/api.md) · [All operations](https://skmtc.net/vercel/apis/api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vercel/api/versions/61d1ba3f6dac/schema)