---
title: "Query per-user activity breakdown for an account"
method: GET
path: "/accounts/{account_id}/reports/userActivity/byUser"
tags: ["Report"]
---

# Query per-user activity breakdown for an account

`GET /accounts/{account_id}/reports/userActivity/byUser`

Retrieve per-user activity counts for an account, broken down by category
(test_authoring, test_maintenance, data_setup, plans_orchestration,
configuration). Only accessible by company admins.

Scope: this endpoint reports automation engineering activity (what users
build, maintain, and configure). Test execution events (ad-hoc test runs,
plan runs, results analysis) are not currently surfaced and may be added
in a future version.

Retention: the underlying activity log retains 400 days of data. The
maximum supported window is 365 days; older queries return partial data.

## Path parameters

- `account_id` string, required

## Query parameters

- `start_time` integer
- `end_time` integer
- `workspace_id` string

## Response `200`

Per-user activity breakdown for the account

- AccountUserActivityByUserResult — Per-user activity breakdown for an account over a time window
  - `account_id` string — The account ID
  - `interval_start` integer — Start of the query time range in epoch milliseconds
  - `interval_end` integer — End of the query time range in epoch milliseconds
  - `by_user` UserActivityRow[] — One row per user with activity in the window. Users with zero actions are not included.
    - `user_id` string — The user ID
    - `email` string — The user's email address
    - `name` string — The user's display name
    - `total_actions` integer — Total user actions in the window after exclusions. Equals the sum of all category fields.
    - `active_days` integer — Number of distinct UTC dates on which the user took at least one counted action.
    - `by_category` UserActivityCategoryCounts — Per-category counts for a single user. The sum of all five fields equals total_actions. See the API documentation for category definitions.
      - `test_authoring` integer — Creates of test, reusable flow (reusable=true), or snippet
      - `test_maintenance` integer — Updates and deletes of test, reusable flow (reusable=true), or snippet
      - `data_setup` integer — Activity on data_table, credentials, file_upload, mailbox, database_connection
      - `plans_orchestration` integer — Activity on plan, environment, branch
      - `workspace_configuration` integer — Account-, workspace-, role-, and integration-level configuration activity
    - `workspaces_touched` string[] — IDs of workspaces in which this user took at least one counted action

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized (not a company admin)
- `default` — Unexpected error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)