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

# List Members

`GET /members`

## Request

- Base URL: `https://api.presentations.ai/api/v1`
- URL: `https://api.presentations.ai/api/v1/members`
- Auth: HTTP bearer

List workspace members with contact details and current roles.

## Query parameters

- `page` integer
- `limit` integer

## Response `200`

Successful Response

- PageMember
  - `data` Member[], required
    - `workspace_id` string, uuid, required
    - `user_id` string, uuid, required
    - `display_name` string, required
    - `email` string, email, required
    - `user` UserContact, required: UserInfo plus email — for member-management surfaces only.
      - `id` string, uuid, required
      - `display_name` string, required
      - `avatar_url` string, nullable, required
      - `email` string, email, required
    - `role` 'OWNER' | 'ADMIN' | 'MEMBER' | 'GUEST', required: Workspace membership role; higher roles subsume lower ones for hierarchy checks.
    - `joined_at` string, date-time, required
  - `page` integer, required
  - `limit` integer, required
  - `total` integer, required

## Other responses

- `401`: Missing, malformed, expired, or revoked Bearer API key.
- `403`: The API key, workspace role, project scope, or plan lacks permission.
- `422`: A path, query, header, or request-body field failed validation.
- `429`: The caller exceeded the API rate limit.
- `500`: Unexpected server failure. Retry only idempotent operations and retain trace_id.

---

[API](https://skmtc.dev/presentations/apis/presentation-services-api.md) · [All operations](https://skmtc.dev/presentations/apis/presentation-services-api/llms.txt) · [OpenAPI document](https://skmtc.dev/presentations/apis/presentation-services-api/revisions/da06cb2e2f32?raw)