# List Teams

See the teams in your company and who is on each one.

`GET https://connect.mindcloud.co/v2/teams`

Permissions: `member:view`.

## Parameters

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. A key can also act in its child organizations, and, with "Use this key across all of your organizations" on, in every organization its creator can open in the app. List them with GET /v2/companies. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

## Example request

```bash
curl --request GET \
  --url 'https://connect.mindcloud.co/v2/teams' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `id` (string): Unique id of the team.
- `name` (string): The team's name, unique in the company (ignoring case).
- `memberUserIds` (array of string): The userIds of the people on the team (List Members), earliest added first.
- `memberCount` (number): How many people are on the team.
- `createdBy` (string): The userId of the member who created the team. Null when it is unknown.
- `createdOn` (date): When the team was created.
- `updatedOn` (date): When the team was last renamed, or created.