---
title: "List teams for the authenticated user"
method: GET
path: "/user/teams"
tags: ["teams"]
---

# List teams for the authenticated user

`GET /user/teams`

List all of the teams across all of the organizations to which the authenticated user belongs. This method requires `user`, `repo`, or `read:org` [scope](https://docs.github.com/enterprise-server@3.6/apps/building-oauth-apps/understanding-scopes-for-oauth-apps/) when authenticating via [OAuth](https://docs.github.com/enterprise-server@3.6/apps/building-oauth-apps/). When using a fine-grained personal access token, the resource owner of the token [must be a single organization](https://docs.github.com/enterprise-server@3.6/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token#fine-grained-personal-access-tokens), and have at least read-only member organization permissions. The response payload only contains the teams from a single organization when using a fine-grained personal access token.

## Query parameters

- `per_page` integer
- `page` integer

## Response `200`

Response

- TeamFull[]
  - `id` integer, required — Unique identifier of the team
  - `node_id` string, required
  - `url` string, uri, required — URL for the team
  - `html_url` string, uri, required
  - `name` string, required — Name of the team
  - `slug` string, required
  - `description` string, nullable, required
  - `privacy` 'closed' | 'secret' — The level of privacy this team should have
  - `permission` string, required — Permission that the team will have for its repositories
  - `members_url` string, required
  - `repositories_url` string, uri, required
  - `parent` NullableTeamSimple, nullable — Groups of organization members that gives permissions on specified repositories.
    - `id` integer, required — Unique identifier of the team
    - `node_id` string, required
    - `url` string, uri, required — URL for the team
    - `members_url` string, required
    - `name` string, required — Name of the team
    - `description` string, nullable, required — Description of the team
    - `permission` string, required — Permission that the team will have for its repositories
    - `privacy` string — The level of privacy this team should have
    - `html_url` string, uri, required
    - `repositories_url` string, uri, required
    - `slug` string, required
    - `ldap_dn` string — Distinguished Name (DN) that team maps to within LDAP environment
  - `members_count` integer, required
  - `repos_count` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `organization` TeamOrganization, required — Team Organization
    - `login` string, required
    - `id` integer, required
    - `node_id` string, required
    - `url` string, uri, required
    - `repos_url` string, uri, required
    - `events_url` string, uri, required
    - `hooks_url` string, required
    - `issues_url` string, required
    - `members_url` string, required
    - `public_members_url` string, required
    - `avatar_url` string, required
    - `description` string, nullable, required
    - `name` string
    - `company` string
    - `blog` string, uri
    - `location` string
    - `email` string, email
    - `twitter_username` string, nullable
    - `is_verified` boolean
    - `has_organization_projects` boolean, required
    - `has_repository_projects` boolean, required
    - `public_repos` integer, required
    - `public_gists` integer, required
    - `followers` integer, required
    - `following` integer, required
    - `html_url` string, uri, required
    - `created_at` string, date-time, required
    - `type` string, required
    - `total_private_repos` integer
    - `owned_private_repos` integer
    - `private_gists` integer, nullable
    - `disk_usage` integer, nullable
    - `collaborators` integer, nullable
    - `billing_email` string, email, nullable
    - `plan` object
      - `name` string, required
      - `space` integer, required
      - `private_repos` integer, required
      - `filled_seats` integer
      - `seats` integer
    - `default_repository_permission` string, nullable
    - `members_can_create_repositories` boolean, nullable
    - `two_factor_requirement_enabled` boolean, nullable
    - `members_allowed_repository_creation_type` string
    - `members_can_create_public_repositories` boolean
    - `members_can_create_private_repositories` boolean
    - `members_can_create_internal_repositories` boolean
    - `members_can_create_pages` boolean
    - `members_can_create_public_pages` boolean
    - `members_can_create_private_pages` boolean
    - `members_can_fork_private_repositories` boolean, nullable
    - `web_commit_signoff_required` boolean
    - `updated_at` string, date-time, required
  - `ldap_dn` string — Distinguished Name (DN) that team maps to within LDAP environment

## Other responses

- `304` — Not modified
- `403` — Forbidden
- `404` — Resource not found

---

[API](https://skmtc.net/github/apis/github-v3-rest-api-5.md) · [All operations](https://skmtc.net/github/apis/github-v3-rest-api-5/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/github/github-v3-rest-api-5/versions/50ae54440071/schema)