---
title: "List Organization Teams"
method: GET
path: "/v1/organizations/{organizationId}/teams"
tags: ["organizations"]
---

# List Organization Teams

`GET /v1/organizations/{organizationId}/teams`

## Request

- Base URL: `https://api.vercel.com`
- URL: `https://api.vercel.com/v1/organizations/{organizationId}/teams`
- Auth: HTTP bearer

List up to 100 teams in an organization, each enriched with the team's slug, name, and avatar. Set `includeMemberCount` to include counts that include pending memberships but exclude email invitations without a membership record. Teams whose underlying record no longer exists are omitted, so a page may contain fewer teams than the page size (or be empty) while still returning a `cursor`; paginate until `cursor` is absent. This endpoint is in private beta. Contact your Vercel account team for access.

## Path parameters

- `organizationId` string, required: The ID of the organization.

## Query parameters

- `cursor` string: Pagination cursor.
- `includeMemberCount` boolean: When true, includes each team's member count in the response.

## Response `200`

- object
  - `cursor` string
  - `teams` OrganizationTeamListItem[], required
    - `avatar` string, nullable, required: The ID of the file used as the Team's avatar, or `null` if none.
    - `billingPlan` 'enterprise' | 'platform': Billing profile of the organization link: how this team settles within the organization. This is not the team's billing.plan or planIteration. Links with `enterprise` billing participate in organization-level billing and usage rollups. This field is optional for legacy links that have no stored profile.
    - `createdAt` string, required: ISO timestamp of when the team was linked to the organization.
    - `memberCount` number: Present only when the request sets `includeMemberCount=true`. Number of members on the Team, including pending memberships. Excludes email invitations that do not have a membership record.
    - `name` string, nullable, required: The Team's display name, or `null` if none has been set.
    - `organizationId` string, required: The ID of the organization the team belongs to.
    - `slug` string, required: The Team's slug, unique across Vercel.
    - `ssoMode` 'organization' | 'team', required
    - `teamId` string, required: The Team's unique identifier.
    - `updatedAt` string, required: ISO timestamp of when the link was last updated.

## 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`

## Changes

- **2026-10-16** `0e48cb239c6a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/vercel/apis/api/changes/v1/organizations/:organizationId/teams/get.md)

---

[API](https://skmtc.dev/vercel/apis/api.md) - [All operations](https://skmtc.dev/vercel/apis/api/llms.txt) - [OpenAPI document](https://skmtc.dev/vercel/apis/api/revisions/4a06e85c2848?raw)