---
title: "GET /api/users/{user}/stats"
method: GET
path: "/api/users/{user}/stats"
tags: ["UserService"]
---

# GET /api/users/{user}/stats

`GET /api/users/{user}/stats`

## Request

- The document declares no server URL.
- Auth: none declared

ListUserStats returns memo statistics for every user who created at least
 one matching memo the caller can read. Use the parent users/- for all
 users, or users/{user} for one user.

## Path parameters

- `user` string, required

## Query parameters

- `filter` string
- `state` 'STATE_UNSPECIFIED' | 'NORMAL' | 'ARCHIVED', enum

## Response `200`

OK

- ListUserStatsResponse: Response message for UserService.ListUserStats.
  - `userStats` UserStats[]: The statistics, one entry per user.
    - `name` string: Identifier. The resource name of the user statistics singleton. Format: users/{user}/stats
    - `totalMemoCount` integer: The number of counted memos.
    - `memoTypeStats` UserStatsMemoTypeStats: MemoTypeStats counts memos by the kind of content they contain.
      - `linkCount` integer: The number of memos that contain a link.
      - `codeCount` integer: The number of memos that contain code.
      - `todoCount` integer: The number of memos that contain a task list.
      - `undoCount` integer: The number of memos that contain incomplete tasks.
    - `tagCounts` object: The number of counted memos per tag.
    - `pinnedMemos` string[]: The pinned memos among the counted memos. Format: memos/{memo}
    - `memoCreatedTimestamps` string[]: The creation timestamps of the counted memos, one per memo.
    - `memoUpdatedTimestamps` string[]: The latest update timestamps of the counted memos (one per memo, mirrors memo_created_timestamps). Used by the activity heatmap when the client's view is set to update_time basis.
    - `attachmentStorageBytes` string: Output only. Total persisted attachment size in bytes, including unlinked uploads and attachments in all spaces. Excludes temporary uploads and derived files. Returned only by GetUserStats for the authenticated user's own stats, independently of the request's memo filter.

## Other responses

- `default`: Default error response

## Changes

- **2026-10-08** `1846a777b0ef`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/usememos/apis/untitled-api/changes/api/users/:user/stats/get.md)

---

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