List team members | Vercel REST API

APIs & SDKs

List team members

GEThttps://api.vercel.com/v3/teams/{teamId}/members

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

https://api.vercel.com/v3/teams/{teamId}/members

const response = await fetch('https://api.vercel.com/v3/teams/teamId/members?limit=123&since=123&until=123&search=string&role=string&excludeProject=string&eligibleMembersForProjectId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "emailInviteCodes": [
    {
      "accessGroups": [],
      "createdAt": "123",
      "email": "user@example.com",
      "entitlements": [],
      "expired": "true",
      "id": "icfg_1234567890",
      "isDSyncUser": "false",
      "projects": "value",
      "role": "BILLING",
      "teamPermissions": [],
      "teamRoles": []
    }
  ],
  "members": [
    {
      "accessRequestedAt": "1588820733602",
      "avatar": "123a6c5209bc3778245d011443644c8d27dc2c50",
      "bitbucket": {
        "login": "string"
      },
      "confirmed": "true",
      "createdAt": "1588720733602",
      "email": "jane.doe@example.com",
      "github": {
        "login": "string"
      },
      "gitlab": {
        "login": "string"
      },
      "isEnterpriseManaged": "false",
      "joinedFrom": {
        "commitId": "example_id",
        "dsyncConnectedAt": "123",
        "dsyncUserId": "example_id",
        "gitUserId": "example_id",
        "gitUserLogin": "string",
        "idpUserId": "example_id",
        "origin": "account-update",
        "repoId": "example_id",
        "repoPath": "string",
        "ssoConnectedAt": "123",
        "ssoUserId": "example_id"
      },
      "name": "Jane Doe",
      "projects": [
        {
          "id": "icfg_1234567890",
          "name": "Example Name",
          "role": "ADMIN"
        }
      ],
      "role": "OWNER",
      "uid": "zTuNVUXEAvvnNN3IaqinkyMw",
      "username": "jane-doe"
    }
  ],
  "pagination": {
    "count": "20",
    "hasNext": "false",
    "next": "1540095775951",
    "prev": "1540095775951"
  }
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Path parameters

teamIdstringRequired

The Team identifier to perform the request on behalf of.

Query parameters

limitnumberOptional

Limit how many teams should be returned

sincenumberOptional

Timestamp in milliseconds to only include members added since then.

untilnumberOptional

Timestamp in milliseconds to only include members added until then.

searchstringOptional

Search team members by their name, username, and email.

rolestringOptional

Only return members with the specified team role.

excludeProjectstringOptional

Exclude members who belong to the specified project.

eligibleMembersForProjectIdstringOptional

Include team members who are eligible to be members of the specified project.

slugstringOptional

The Team slug to perform the request on behalf of.

Response

200Success

emailInviteCodesarrayOptional

membersarrayRequired

paginationobjectRequired

Errors

400One of the provided values in the request query is invalid.

401The request is not authorized.

403You do not have permission to access this resource.

404Error

410Error

Cross-link map: List team members (/docs/rest-api/teams/list-team-members)

From the Vercel docs graph (built 2026-10-10T05:32:43.016Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

List all teams — GET /v2/teams — Get a paginated list of all the Teams the authenticated User is a member of.
Invite a user — POST /v2/teams/{teamId}/members — Invite a user to join the team specified in the URL. The authenticated user needs to b
List project members — GET /v1/projects/{idOrName}/members — Lists all members of a project.
List access groups for a team, project or member — GET /v1/access-groups — List access groups
Request access to a team — POST /v1/teams/{teamId}/request — Request access to a team as a member. An owner has to approve the request. Only 100 us

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (1)

By site: vercel-docs (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/v3/teams/{teamId}/members

const response = await fetch('https://api.vercel.com/v3/teams/teamId/members?limit=123&since=123&until=123&search=string&role=string&excludeProject=string&eligibleMembersForProjectId=string&slug=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "emailInviteCodes": [
    {
      "accessGroups": [],
      "createdAt": "123",
      "email": "user@example.com",
      "entitlements": [],
      "expired": "true",
      "id": "icfg_1234567890",
      "isDSyncUser": "false",
      "projects": "value",
      "role": "BILLING",
      "teamPermissions": [],
      "teamRoles": []
    }
  ],
  "members": [
    {
      "accessRequestedAt": "1588820733602",
      "avatar": "123a6c5209bc3778245d011443644c8d27dc2c50",
      "bitbucket": {
        "login": "string"
      },
      "confirmed": "true",
      "createdAt": "1588720733602",
      "email": "jane.doe@example.com",
      "github": {
        "login": "string"
      },
      "gitlab": {
        "login": "string"
      },
      "isEnterpriseManaged": "false",
      "joinedFrom": {
        "commitId": "example_id",
        "dsyncConnectedAt": "123",
        "dsyncUserId": "example_id",
        "gitUserId": "example_id",
        "gitUserLogin": "string",
        "idpUserId": "example_id",
        "origin": "account-update",
        "repoId": "example_id",
        "repoPath": "string",
        "ssoConnectedAt": "123",
        "ssoUserId": "example_id"
      },
      "name": "Jane Doe",
      "projects": [
        {
          "id": "icfg_1234567890",
          "name": "Example Name",
          "role": "ADMIN"
        }
      ],
      "role": "OWNER",
      "uid": "zTuNVUXEAvvnNN3IaqinkyMw",
      "username": "jane-doe"
    }
  ],
  "pagination": {
    "count": "20",
    "hasNext": "false",
    "next": "1540095775951",
    "prev": "1540095775951"
  }
}

OpenAPI Specification