---
title: "List team members"
method: GET
path: "/v1/team/members"
tags: ["Team"]
---

# List team members

`GET /v1/team/members`

## Request

- Base URL: `https://api.frihet.io`
- URL: `https://api.frihet.io/v1/team/members`
- Auth: API key in header `X-API-Key`

Returns active team members and pending invitations for the workspace.

## Query parameters

- `role` 'owner' | 'admin' | 'viewer' | 'editor' | 'accountant'
- `status` 'active' | 'pending'
- `limit` integer
- `offset` integer

## Response `200`

List of team members and pending invitations

- object
  - `data` TeamMember[]
    - `id` string: Member or invitation document ID
    - `email` string, email
    - `name` string, nullable
    - `role` 'owner' | 'admin' | 'viewer' | 'editor' | 'accountant'
    - `status` 'active' | 'pending'
    - `joinedAt` string, date-time, nullable: Set for active members
    - `invitedAt` string, date-time, nullable: Set for pending invitations
    - `expiresAt` string, date-time, nullable: Invite expiry (pending only)
  - `total` integer
  - `limit` integer
  - `offset` integer

## Other responses

- `401`: Authentication required or invalid API key
- `429`: Rate limit exceeded (100 requests per minute)
- `500`: Internal server error

---

[API](https://skmtc.dev/frihet/apis/frihet-api.md) · [All operations](https://skmtc.dev/frihet/apis/frihet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frihet/apis/frihet-api/revisions/3dd37f6a72d1?raw)