---
title: "List team users"
method: GET
path: "/v1/account/users"
tags: ["Team Users"]
---

# List team users

`GET /v1/account/users`

## Request

- Base URL: `https://api.winnr.app`
- URL: `https://api.winnr.app/v1/account/users`
- Auth: HTTP bearer

Returns all team users (dashboard members) for the authenticated account.
Users are sorted by role (owner first, then admins, then members) then by email.

## Response `200`

List of team users

- object
  - `meta` Meta
    - `request_id` string
    - `timestamp` string, date-time
  - `data` object
    - `users` TeamUser[]
      - `id` string: User ID
      - `email` string, email
      - `display_name` string
      - `first_name` string
      - `last_name` string
      - `photo_url` string, uri
      - `role` 'superadmin' | 'admin' | 'member': User role: - superadmin: Account owner (cannot be modified or deleted) - admin: Can manage domains, users, and settings - member: Can view and use email accounts
      - `is_admin` boolean
      - `is_superadmin` boolean
      - `created_at` string, date-time
    - `total` integer: Total number of team users

## Other responses

- `401`: Authentication required or token invalid

---

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