---
title: "List Users"
method: GET
path: "/api/v1/admin/users"
tags: ["admin"]
---

# List Users

`GET /api/v1/admin/users`

## Request

- Base URL: `https://memory.kagura-ai.com` (the document declares no server; this is the origin it was published from)
- URL: `https://memory.kagura-ai.com/api/v1/admin/users`
- Auth: none declared

List all users with their memory statistics.

Admin-only endpoint.

Issue #164: Extended with search/filter capabilities and workspace info.

Args:
    user: Authenticated admin user
    db: Database session
    limit: Maximum number of users to return
    offset: Pagination offset
    include_workspaces: Include workspace membership info
    search: Search by email or name (partial match)
    workspace_id: Filter by workspace ID
    role: Filter by system role (admin/user)
    plan: Filter by plan tier (free/basic/pro/promax)
    sort: Sort field (created_at, last_login, memory_count)

Returns:
    List of users with memory counts, storage usage, and optionally workspace info

## Query parameters

- `limit` integer
- `offset` integer
- `include_workspaces` boolean
- `search` string, nullable
- `workspace_id` string, nullable
- `role` string, nullable
- `plan` string, nullable
- `sort` string

## Response `200`

Successful Response

- UserListResponse: Response for user list.
  - `users` UserInfo[], required
    - `id` unknown, required
    - `email` unknown, required
    - `name` unknown, required
    - `picture` unknown
    - `role` unknown, required
    - `created_at` unknown, required
    - `last_login` unknown
    - `memory_count` unknown, required
    - `is_active` unknown, required
    - `timezone` unknown
    - `auth_provider` unknown
    - `workspaces` unknown
    - `owned_count` unknown
    - `workspace_slot_bonus` unknown
    - `base_cap` unknown
    - `cap` unknown
  - `total` integer, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud.md) · [All operations](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/llms.txt) · [OpenAPI document](https://skmtc.dev/kagura-ai/apis/kagura-memory-cloud/revisions/aa9df1a21db9?raw)