---
title: "Get team"
method: GET
path: "/api/v2/teams/{teamKey}"
tags: ["Teams"]
---

# Get team

`GET /api/v2/teams/{teamKey}`

Fetch a team by key.

### Expanding the teams response
LaunchDarkly supports several fields for expanding the "Get team" response. By default, these fields are **not** included in the response.

To expand the response, append the `expand` query parameter and add a comma-separated list with any of the following fields:

* `members` includes the total count of members that belong to the team.
* `roles` includes a paginated list of the custom roles that you have assigned to the team.
* `roleAttributes` includes a list of the role attributes that you have assigned to the team.
* `projects` includes a paginated list of the projects that the team has any write access to.
* `maintainers` includes a paginated list of the maintainers that you have assigned to the team.

For example, `expand=members,roles` includes the `members` and `roles` fields in the response.

## Path parameters

- `teamKey` string, string, required — The team key.

## Query parameters

- `expand` string, string — A comma-separated list of properties that can reveal additional information in the response.

## Response `200`

Teams response

- Team
  - `description` string — A description of the team
  - `key` string — The team key
  - `name` string — A human-friendly name for the team
  - `_access` Access
    - `denied` AccessDenied[], required
      - `action` string, required
      - `reason` AccessDeniedReason, required
        - `resources` string[] — Resource specifier strings
        - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
        - `actions` ActionSpecifier[] — Actions to perform on a resource
        - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
        - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
        - `role_name` string
    - `allowed` AccessAllowedRep[], required
      - `action` string, required
      - `reason` AccessAllowedReason, required
        - `resources` string[] — Resource specifier strings
        - `notResources` string[] — Targeted resources are the resources NOT in this list. The <code>resources</code> and <code>notActions</code> fields must be empty to use this field.
        - `actions` ActionSpecifier[] — Actions to perform on a resource
        - `notActions` ActionSpecifier[] — Targeted actions are the actions NOT in this list. The <code>actions</code> and <code>notResources</code> fields must be empty to use this field.
        - `effect` 'allow' | 'deny', required — Whether this statement should allow or deny actions on the resources.
        - `role_name` string
  - `_creationDate` integer
  - `_links` object — The location and content type of related resources
  - `_lastModified` integer
  - `_version` integer — The team version
  - `_idpSynced` boolean — Whether the team has been synced with an external identity provider (IdP). Team sync is available to customers on an Enterprise plan.
  - `roleAttributes` RoleAttributeMap
  - `roles` TeamCustomRoles
    - `totalCount` integer — The number of custom roles assigned to this team
    - `items` TeamCustomRole[] — An array of the custom roles that have been assigned to this team
      - `key` string — The key of the custom role
      - `name` string — The name of the custom role
      - `projects` TeamProjects
        - `totalCount` integer
        - `items` ProjectSummary[] — Details on each project where team members have write privileges on at least one resource type (e.g. flags)
          - `_id` string, required — The ID of this project
          - `_links` object, required — The location and content type of related resources
          - `key` string, required — The project key
          - `name` string, required — The project name
      - `appliedOn` integer
    - `_links` object — The location and content type of related resources
  - `members` TeamMembers
    - `totalCount` integer — The total count of members that belong to the team
  - `projects` TeamProjects
    - `totalCount` integer
    - `items` ProjectSummary[] — Details on each project where team members have write privileges on at least one resource type (e.g. flags)
      - `_id` string, required — The ID of this project
      - `_links` object, required — The location and content type of related resources
      - `key` string, required — The project key
      - `name` string, required — The project name
  - `maintainers` TeamMaintainers
    - `totalCount` integer — The number of maintainers of the team
    - `items` MemberSummary[] — Details on the members that have been assigned as maintainers of the team
      - `_links` object, required — The location and content type of related resources
      - `_id` string, required — The member's ID
      - `firstName` string — The member's first name
      - `lastName` string — The member's last name
      - `role` string, required — The member's base role. If the member has no additional roles, this role will be in effect.
      - `email` string, required — The member's email address
    - `_links` object — The location and content type of related resources

## Other responses

- `400` — Invalid request
- `401` — Invalid access token
- `403` — Forbidden
- `404` — Invalid resource identifier
- `405` — Method not allowed
- `429` — Rate limited

---

[API](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api.md) · [All operations](https://skmtc.dev/launchdarkly/apis/launchdarkly-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/launchdarkly/launchdarkly-rest-api/revisions/69c5c9aafe78/schema)