---
title: "Stats Active Users"
method: GET
path: "/api/admin/stats/active-users"
tags: ["admin"]
---

# Stats Active Users

`GET /api/admin/stats/active-users`

## Request

- Base URL: `https://fojin.app` (the document declares no server; this is the origin it was published from)
- URL: `https://fojin.app/api/admin/stats/active-users`
- Auth: HTTP bearer

Per-user breakdown of who was active (chatted or read) on a given day.

Drill-down for the active-users trend point; not cached (admin-only, low
volume, must reflect the live day).

## Query parameters

- `date` string, date, required: Local-day (Asia/Shanghai) to break down, YYYY-MM-DD

## Response `200`

Successful Response

- ActiveUserDayDetail
  - `date` string, required
  - `total` integer, required
  - `users` ActiveUserDetail[], required
    - `user_id` integer, required
    - `username` string, nullable
    - `display_name` string, nullable
    - `email` string, nullable
    - `role` string, required
    - `chat_messages` integer, required
    - `texts_read` integer, required
    - `last_active_at` string, date-time, nullable
    - `api_provider` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform.md) · [All operations](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform/llms.txt) · [OpenAPI document](https://skmtc.dev/fojin/apis/fojin-api-buddhist-digital-text-platform/revisions/969714238c61?raw)