---
title: "List team members"
method: GET
path: "/v3/teams/{teamId}/members"
tags: ["teams"]
---

# List team members

`GET /v3/teams/{teamId}/members`

Get a paginated list of team members for the provided team.

## Path parameters

- `teamId` string, required

## Query parameters

- `limit` number — Limit how many teams should be returned
- `since` number — Timestamp in milliseconds to only include members added since then.
- `until` number — Timestamp in milliseconds to only include members added until then.
- `search` string — Search team members by their name, username, and email.
- `role` 'OWNER' | 'MEMBER' | 'DEVELOPER' | 'SECURITY' | 'BILLING' | 'VIEWER' | 'VIEWER_FOR_PLUS' | 'CONTRIBUTOR' — Only return members with the specified team role.
- `excludeProject` string — Exclude members who belong to the specified project.
- `eligibleMembersForProjectId` string — Include team members who are eligible to be members of the specified project.
- `slug` string

## Response `200`

- object
  - `members` object[], required
    - `avatar` string — ID of the file for the Avatar of this member.
    - `confirmed` false | true, required — Boolean that indicates if this member was confirmed by an owner.
    - `email` string, required — The email of this member.
    - `github` object — Information about the GitHub account for this user.
      - `login` string
    - `gitlab` object — Information about the GitLab account of this user.
      - `login` string
    - `bitbucket` object — Information about the Bitbucket account of this user.
      - `login` string
    - `role` 'BILLING' | 'CONTRIBUTOR' | 'DEVELOPER' | 'MEMBER' | 'OWNER' | 'SECURITY' | 'VIEWER' | 'VIEWER_FOR_PLUS', required — Role of this user in the team.
    - `uid` string, required — The ID of this user.
    - `username` string, required — The unique username of this user.
    - `name` string — The name of this user.
    - `createdAt` number, required — Timestamp in milliseconds when this member was added.
    - `accessRequestedAt` number — Timestamp in milliseconds for when this team member was accepted by an owner.
    - `joinedFrom` object — Map with information about the members origin if they joined by requesting access.
      - `origin` 'account-update' | 'bitbucket' | 'dsync' | 'feedback' | 'github' | 'gitlab' | 'import' | 'link' | 'mail' | 'nsnb-auto-approve' | 'nsnb-hobby-upgrade' | 'nsnb-invite' | 'nsnb-redeploy' | 'nsnb-redeploy-attribution-card' | 'nsnb-request-access' | 'nsnb-viewer-upgrade' | 'organization-teams' | 'saml' | 'teams', required
      - `commitId` string
      - `repoId` string
      - `repoPath` string
      - `gitUserId` union
        - string
        - number
      - `gitUserLogin` string
      - `ssoUserId` string
      - `ssoConnectedAt` number
      - `idpUserId` string
      - `dsyncUserId` string
      - `dsyncConnectedAt` number
    - `projects` object[] — Array of project memberships
      - `name` string, required
      - `id` string, required
      - `role` 'ADMIN' | 'PROJECT_DEVELOPER' | 'PROJECT_GUEST' | 'PROJECT_VIEWER'
    - `isEnterpriseManaged` false | true — Indicates whether the user is managed by an enterprise.
  - `emailInviteCodes` object[]
    - `accessGroups` string[]
    - `id` string, required
    - `email` string
    - `role` 'BILLING' | 'CONTRIBUTOR' | 'DEVELOPER' | 'MEMBER' | 'OWNER' | 'SECURITY' | 'VIEWER' | 'VIEWER_FOR_PLUS'
    - `teamRoles` string[]
    - `teamPermissions` string[]
    - `isDSyncUser` false | true, required
    - `createdAt` number
    - `expired` true
    - `projects` object
    - `entitlements` string[]
  - `pagination` object, required
    - `hasNext` false | true, required
    - `count` number, required — Amount of items in the current page.
    - `next` number, nullable, required — Timestamp that must be used to request the next page.
    - `prev` number, nullable, required — Timestamp that must be used to request the previous page.

## 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.
- `404`
- `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/b4d86a3e3479/schema)