---
title: "List members"
method: GET
path: "/members"
tags: ["Members"]
---

# List members

`GET /members`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/members`
- Auth: HTTP bearer

Returns the members of the authenticated account, optionally filtered by role.

## Query parameters

- `role` 'owner' | 'admin' | 'member': Filter the returned members by role.
- `suspended` 'true' | 'false': Filter by suspension state: `true` or `false`.

## Response `200`

Successful response.

- object
  - `object` 'list', required
  - `url` string, required
  - `hasMore` boolean, required
  - `nextCursor` string, nullable, required
  - `data` Member[], required
    - `id` string, required: Unique identifier for the membership.
    - `object` 'member', required: String representing the object's type.
    - `userId` string, required: Identifier of the user behind the member.
    - `email` string, required: The member's email address.
    - `name` string, required: The member's display name.
    - `avatarUrl` string, nullable, required: URL of the member's avatar, or `null` if none is set.
    - `role` string, required: The member's role in the account.
    - `suspended` boolean, required: Whether the member is currently suspended.
    - `joinedAt` string, required: ISO-8601 timestamp of when the member joined the account.
    - `isPrimaryOwner` boolean, required: Whether the member is the account primary owner.

## Other responses

- `default`: An error. Every non-2xx response uses the same envelope; see the Errors section of the introduction.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `default` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/members/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)