List all teams | Vercel REST API

APIs & SDKs

List all teams

GEThttps://api.vercel.com/v2/teams

Get a paginated list of all the Teams the authenticated User is a member of.

https://api.vercel.com/v2/teams

const response = await fetch('https://api.vercel.com/v2/teams?limit=123&since=123&until=123', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

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

Response

{
  "pagination": {
    "count": "20",
    "next": "1540095775951",
    "prev": "1540095775951"
  },
  "teams": [
    {
      "apiKeysInvalidatedAt": "123",
      "appTokensInvalidatedAt": "123",
      "avatar": "6eb07268bcfadd309905ffb1579354084c24655c",
      "billing": {
        "plan": "enterprise"
      },
      "connect": {
        "enabled": "false"
      },
      "createdAt": "1630748523395",
      "creatorId": "R6efeCJQ2HKXywuasPDc0fOWB",
      "defaultContinuousUsageKind": "metered",
      "defaultDeploymentProtection": {
        "passwordProtection": {
          "deploymentType": "string"
        },
        "ssoProtection": {
          "deploymentType": "string"
        }
      },
      "defaultExpirationSettings": {
        "deploymentsToKeep": "123",
        "expirationDays": "123",
        "expirationDaysCanceled": "123",
        "expirationDaysErrored": "123",
        "expirationDaysProduction": "123"
      },
      "defaultPassport": {
        "connectorId": "example_id",
        "deploymentType": "all"
      },
      "defaultProjectJobs": {
        "flag-definitions-present": {
          "targets": []
        },
        "lint": {
          "targets": []
        },
        "mfe-config-present": {
          "targets": []
        },
        "typecheck": {
          "targets": []
        }
      },
      "defaultRoles": {
        "teamPermissions": [],
        "teamRoles": []
      },
      "deploymentPolicy": {
        "deploymentSources": [
          {
            "enabled": "false",
            "environments": [
              {
                "target": "preview",
                "type": "system"
              }
            ],
            "sources": []
          }
        ],
        "gitSources": [
          {
            "enabled": "false",
            "environments": [
              {
                "target": "preview",
                "type": "system"
              }
            ],
            "sources": [
              {
                "org": "string",
                "provider": "bitbucket",
                "repo": "string"
              }
            ]
          }
        ]
      },
      "deploymentStorageRollout": {
        "cohort": "already_metered",
        "meteredAt": "123",
        "meterReason": "low_scheduled",
        "retentionAppliedAt": "123",
        "retentionOptOutAt": "123"
      },
      "description": "Our mission is to make cloud computing accessible to everyone.",
      "disableHardAutoBlocks": "123",
      "disableRepositoryDispatchEvents": "false",
      "disjunctiveProductionSecretPolicy": "default",
      "dpAccessRequestsMode": "all",
      "emailDomain": "example.com",
      "enablePreviewFeedback": "default",
      "enableProductionFeedback": "default",
      "hideIpAddresses": "false",
      "hideIpAddressesInLogDrains": "false",
      "id": "team_nllPyCtREAqxxdyFKbbMDlxd",
      "integrationTokensInvalidatedAt": "123",
      "inviteCode": "hasihf9e89",
      "ipBuckets": [
        {
          "bucket": "string",
          "default": "false",
          "supportUntil": "123"
        }
      ],
      "limited": "false",
      "membership": {
        "accessRequestedAt": "123",
        "confirmed": "true",
        "created": "123",
        "createdAt": "123",
        "entitlements": [
          {
            "entitlement": "string"
          }
        ],
        "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"
        },
        "organizationId": "example_id",
        "role": "BILLING",
        "teamId": "example_id",
        "teamPermissions": [],
        "teamRoles": [],
        "uid": "example_id"
      },
      "name": "My Team",
      "nsnbConfig": {
        "preference": "auto-approval"
      },
      "orgRootTeamId": "team_nllPyCtREAqxxdyFKbbMDlxd",
      "parentId": "org_nllPyCtREAqxxdyFKbbMDlxd",
      "personalAccessTokensInvalidatedAt": "123",
      "platform": "true",
      "previewDeploymentSuffix": "example.dev",
      "remoteCaching": {
        "enabled": "false"
      },
      "requireVerifiedCommits": "false",
      "resourceConfig": {
        "blobStores": "123",
        "buildEntitlements": {
          "enhancedBuilds": "false"
        },
        "buildMachine": {
          "default": "basic"
        },
        "concurrentBuilds": "123",
        "customEnvironmentsPerProject": "123",
        "edgeConfigs": "123",
        "edgeConfigSize": "123",
        "elasticConcurrencyEnabled": "false",
        "kvDatabases": "123",
        "postgresDatabases": "123",
        "serverlessFunctionMaxMemorySize": "123"
      },
      "saml": {
        "connection": {
          "connectedAt": "1611796915677",
          "lastReceivedWebhookEvent": "1611796915677",
          "lastSyncedAt": "1611796915677",
          "state": "active",
          "syncState": "ACTIVE",
          "type": "OktaSAML",
          "status": "string"
        },
        "defaultRedirectUri": "v0.app",
        "directory": {
          "connectedAt": "1611796915677",
          "lastReceivedWebhookEvent": "1611796915677",
          "lastSyncedAt": "1611796915677",
          "state": "active",
          "syncState": "ACTIVE",
          "type": "OktaSAML"
        },
        "enforced": "false",
        "roles": "value"
      },
      "sensitiveEnvironmentVariablePolicy": "default",
      "slug": "my-team",
      "stagingPrefix": "string",
      "strictConnectors": {
        "enabled": "false",
        "updatedAt": "123"
      },
      "strictDeploymentProtectionSettings": {
        "enabled": "false",
        "updatedAt": "123"
      },
      "strictPasswordProtectionSettings": {
        "enabled": "false",
        "updatedAt": "123"
      },
      "strictShareableLinks": {
        "enabled": "false",
        "updatedAt": "123"
      },
      "updatedAt": "1611796915677"
    }
  ]
}

Authentication

AuthorizationbearerToken

Default authentication mechanism

Query parameters

limitnumberOptional

Maximum number of Teams which may be returned.

sincenumberOptional

Timestamp (in milliseconds) to only include Teams created since then.

untilnumberOptional

Timestamp (in milliseconds) to only include Teams created until then.

Response

200A paginated list of teams.

paginationobjectRequired

This object contains information related to the pagination of the current request, including the necessary parameters to get the next or previous page of data.

teamsarrayRequired

Errors

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

403You do not have permission to access this resource.

410Error

500Error

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

From the Vercel docs graph (built 2026-10-08T05:38:39.548Z), 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 team members — GET /v3/teams/{teamId}/members — Get a paginated list of team members for the provided team.
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
Get access request status — GET /v1/teams/{teamId}/request/{userId} — Check the status of a join request. It'll respond with a 404 if the request ha
List invocations for a team, optionally filtered by repository and invocation metadata — GET /v2/vercel-ci/invocations — List Invocations
List access groups for a team, project or member — GET /v1/access-groups — List access groups

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 (2)

By site: vercel-docs (2)

Account Management — Learn how to manage your Vercel account and team members.
Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/v2/teams

const response = await fetch('https://api.vercel.com/v2/teams?limit=123&since=123&until=123', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

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

Response

{
  "pagination": {
    "count": "20",
    "next": "1540095775951",
    "prev": "1540095775951"
  },
  "teams": [
    {
      "apiKeysInvalidatedAt": "123",
      "appTokensInvalidatedAt": "123",
      "avatar": "6eb07268bcfadd309905ffb1579354084c24655c",
      "billing": {
        "plan": "enterprise"
      },
      "connect": {
        "enabled": "false"
      },
      "createdAt": "1630748523395",
      "creatorId": "R6efeCJQ2HKXywuasPDc0fOWB",
      "defaultContinuousUsageKind": "metered",
      "defaultDeploymentProtection": {
        "passwordProtection": {
          "deploymentType": "string"
        },
        "ssoProtection": {
          "deploymentType": "string"
        }
      },
      "defaultExpirationSettings": {
        "deploymentsToKeep": "123",
        "expirationDays": "123",
        "expirationDaysCanceled": "123",
        "expirationDaysErrored": "123",
        "expirationDaysProduction": "123"
      },
      "defaultPassport": {
        "connectorId": "example_id",
        "deploymentType": "all"
      },
      "defaultProjectJobs": {
        "flag-definitions-present": {
          "targets": []
        },
        "lint": {
          "targets": []
        },
        "mfe-config-present": {
          "targets": []
        },
        "typecheck": {
          "targets": []
        }
      },
      "defaultRoles": {
        "teamPermissions": [],
        "teamRoles": []
      },
      "deploymentPolicy": {
        "deploymentSources": [
          {
            "enabled": "false",
            "environments": [
              {
                "target": "preview",
                "type": "system"
              }
            ],
            "sources": []
          }
        ],
        "gitSources": [
          {
            "enabled": "false",
            "environments": [
              {
                "target": "preview",
                "type": "system"
              }
            ],
            "sources": [
              {
                "org": "string",
                "provider": "bitbucket",
                "repo": "string"
              }
            ]
          }
        ]
      },
      "deploymentStorageRollout": {
        "cohort": "already_metered",
        "meteredAt": "123",
        "meterReason": "low_scheduled",
        "retentionAppliedAt": "123",
        "retentionOptOutAt": "123"
      },
      "description": "Our mission is to make cloud computing accessible to everyone.",
      "disableHardAutoBlocks": "123",
      "disableRepositoryDispatchEvents": "false",
      "disjunctiveProductionSecretPolicy": "default",
      "dpAccessRequestsMode": "all",
      "emailDomain": "example.com",
      "enablePreviewFeedback": "default",
      "enableProductionFeedback": "default",
      "hideIpAddresses": "false",
      "hideIpAddressesInLogDrains": "false",
      "id": "team_nllPyCtREAqxxdyFKbbMDlxd",
      "integrationTokensInvalidatedAt": "123",
      "inviteCode": "hasihf9e89",
      "ipBuckets": [
        {
          "bucket": "string",
          "default": "false",
          "supportUntil": "123"
        }
      ],
      "limited": "false",
      "membership": {
        "accessRequestedAt": "123",
        "confirmed": "true",
        "created": "123",
        "createdAt": "123",
        "entitlements": [
          {
            "entitlement": "string"
          }
        ],
        "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"
        },
        "organizationId": "example_id",
        "role": "BILLING",
        "teamId": "example_id",
        "teamPermissions": [],
        "teamRoles": [],
        "uid": "example_id"
      },
      "name": "My Team",
      "nsnbConfig": {
        "preference": "auto-approval"
      },
      "orgRootTeamId": "team_nllPyCtREAqxxdyFKbbMDlxd",
      "parentId": "org_nllPyCtREAqxxdyFKbbMDlxd",
      "personalAccessTokensInvalidatedAt": "123",
      "platform": "true",
      "previewDeploymentSuffix": "example.dev",
      "remoteCaching": {
        "enabled": "false"
      },
      "requireVerifiedCommits": "false",
      "resourceConfig": {
        "blobStores": "123",
        "buildEntitlements": {
          "enhancedBuilds": "false"
        },
        "buildMachine": {
          "default": "basic"
        },
        "concurrentBuilds": "123",
        "customEnvironmentsPerProject": "123",
        "edgeConfigs": "123",
        "edgeConfigSize": "123",
        "elasticConcurrencyEnabled": "false",
        "kvDatabases": "123",
        "postgresDatabases": "123",
        "serverlessFunctionMaxMemorySize": "123"
      },
      "saml": {
        "connection": {
          "connectedAt": "1611796915677",
          "lastReceivedWebhookEvent": "1611796915677",
          "lastSyncedAt": "1611796915677",
          "state": "active",
          "syncState": "ACTIVE",
          "type": "OktaSAML",
          "status": "string"
        },
        "defaultRedirectUri": "v0.app",
        "directory": {
          "connectedAt": "1611796915677",
          "lastReceivedWebhookEvent": "1611796915677",
          "lastSyncedAt": "1611796915677",
          "state": "active",
          "syncState": "ACTIVE",
          "type": "OktaSAML"
        },
        "enforced": "false",
        "roles": "value"
      },
      "sensitiveEnvironmentVariablePolicy": "default",
      "slug": "my-team",
      "stagingPrefix": "string",
      "strictConnectors": {
        "enabled": "false",
        "updatedAt": "123"
      },
      "strictDeploymentProtectionSettings": {
        "enabled": "false",
        "updatedAt": "123"
      },
      "strictPasswordProtectionSettings": {
        "enabled": "false",
        "updatedAt": "123"
      },
      "strictShareableLinks": {
        "enabled": "false",
        "updatedAt": "123"
      },
      "updatedAt": "1611796915677"
    }
  ]
}

OpenAPI Specification