---
title: "List members of a team"
method: GET
path: "/teams/{teamId}/members"
tags: ["Teams"]
---

# List members of a team

`GET /teams/{teamId}/members`

## Request

- Base URL: `https://api3.autarc.energy/v1`
- URL: `https://api3.autarc.energy/v1/teams/{teamId}/members`
- Auth: API key in header `X-Api-Key`

Paginated live members of one team. Soft-deleted memberships are omitted. `role` is the team membership role (`leader` or `member`). Company role, phone and profile status stay on `GET /team-members`.

## Path parameters

- `teamId` string, uuid, required

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Paginated live members of one team

- TeamMemberRefs
  - `items` TeamMemberRef[], required
    - `id` string, uuid, required: Profile ID. Same value as `id` on `GET /team-members`.
    - `firstName` string, nullable
    - `lastName` string, nullable
    - `email` string, email, required
    - `role` 'leader' | 'member', required
  - `metadata` object, required
    - `page` integer, required: Current page of the results
    - `limit` integer, required: Number of results per page
    - `total` integer, required: Total number of members matching the query

## Other responses

- `400`: Invalid request — missing or malformed fields, unsupported mime type or fileType, or empty file.
- `404`: The specified resource was not found

---

[API](https://skmtc.dev/autarc/apis/autarc-2-0-api.md) - [All operations](https://skmtc.dev/autarc/apis/autarc-2-0-api/llms.txt) - [OpenAPI document](https://skmtc.dev/autarc/apis/autarc-2-0-api/revisions/adfb20a40efc?raw)