---
title: "GET /api/v1/users:stats"
method: GET
path: "/api/v1/users:stats"
tags: ["UserService"]
---

# GET /api/v1/users:stats

`GET /api/v1/users:stats`

ListAllUserStats returns statistics for all users.

## Query parameters

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

## Response `200`

OK

- ListAllUserStatsResponse
  - `stats` UserStats[] — The list of user statistics.
    - `name` string — The resource name of the user statistics singleton. Format: users/{user}/stats
    - `memoTypeStats` UserStatsMemoTypeStats — Memo type statistics.
      - `linkCount` integer
      - `codeCount` integer
      - `todoCount` integer
      - `undoCount` integer
    - `tagCount` object — The count of tags.
    - `memoCreatedTimestamps` string[] — The creation timestamps of the user's memos.
    - `memoUpdatedTimestamps` string[] — The latest update timestamps of the user's memos (one per memo, mirrors memo_created_timestamps). Used by the activity heatmap when the client's view is set to update_time basis.
    - `pinnedMemos` string[] — The pinned memos of the user.
    - `totalMemoCount` integer — Total memo count.

## Other responses

- `default` — Default error response

## Changes

> 63 revisions in range; 51 could not be searched.

- **2025-12-15** `d740073f088f` — 4 warning, 1 info
  - deleted the `query` request parameter `filter`
  - deleted the `query` request parameter `state`
  - removed the optional property `stats/items/memoCreatedTimestamps` from the response with the `200` status
  - removed the optional property `stats/items/memoUpdatedTimestamps` from the response with the `200` status
  - …1 more

[Change history](https://skmtc.dev/usememos/apis/untitled-api/changes/api/v1/users: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-service-production.skmtc.workers.dev/v1/apis/usememos/untitled-api/revisions/9f2688df7c2e/schema)