---
title: "List visible user groups as a tree"
method: GET
path: "/v3/groups/tree"
tags: ["[v3] Groups"]
---

# List visible user groups as a tree

`GET /v3/groups/tree`

Returns the user-group tree visible to the authenticated caller, with distinct active-user counts. The result is independent of any project or task assignment.

## Response `200`

Visible group tree.

- GroupTreeResponse
  - `data` GroupTreeNode[], required
    - `groupId` integer, required
    - `name` string, required
    - `directUsersCount` integer, required — Number of distinct active users assigned directly to this group.
    - `usersCountWithSubgroups` integer, required — Number of distinct active users in this group and all visible descendant groups.
    - `children` GroupTreeNode[], required

## Other responses

- `401` — Authentication is required.
- `403` — The authenticated OAuth2 access token or PAT does not contain any scope accepted by the endpoint.
- `500` — Internal server error.

---

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