---
title: "Get all members of a team"
method: GET
path: "/v3/teams/{teamId}/users"
tags: ["v3 team members"]
---

# Get all members of a team

`GET /v3/teams/{teamId}/users`

## Request

- Base URL: `https://api.resourcewatch.org`
- URL: `https://api.resourcewatch.org/v3/teams/{teamId}/users`
- Auth: HTTP bearer

Get all memebers of a team, the authenticated user must be a member of the team.

If the authenticated user is an "administrator" or a "manager" of the team they will be able to see each user's `status`, otherwise this key will be hidden.

## Response `200`

Example response

- object
  - `data` object[], required
    - `id` string, required
    - `type` string, required
    - `attributes` TeamUserRelation, required
      - `teamId` string, required
      - `userId` string
      - `email` string, email, required
      - `role` 'administrator' | 'manager' | 'monitor' | 'left', required
      - `status` 'confirmed' | 'invited' | 'declined', required
      - `name` string

## Other responses

- `401`: Error Response

## Changes

- **2022-07-01** `dcbff9c77fe8`: 1 info
  - added the optional property `data/items/attributes/name` to the response with the `200` status
- **2022-05-19** `4bc9eb243ae0`: 4 info
  - the response property `data` became required for the status `200`
  - the response property `data/items/attributes` became required for the status `200`
  - the response property `data/items/id` became required for the status `200`
  - the response property `data/items/type` became required for the status `200`
- **2022-05-05** `9de002b42c17`: 2 info
  - api tag `v3 team members` added
  - api tag `v3` removed
- **2022-04-29** `318e32d5b89c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/wri/apis/fw-teams/changes/v3/teams/:teamId/users/get.md)

---

[API](https://skmtc.dev/wri/apis/fw-teams.md) - [All operations](https://skmtc.dev/wri/apis/fw-teams/llms.txt) - [OpenAPI document](https://skmtc.dev/wri/apis/fw-teams/revisions/9e208e657f30?raw)
