---
title: "Get sub users"
method: GET
path: "/sub_user/list"
tags: ["Sub Users"]
---

# Get sub users

`GET /sub_user/list`

Retrieves the sub users the calling user may manage: every sub user in the account for an administrator, only the caller's own sub users otherwise. Sub users themselves are refused entirely.

## Response `200`

OK

- object
  - `sub_users` SubUser[], required
    - `id` integer, required — unique identifier of the sub user
    - `assigned_policies` SubUserPolicy[], required — the policies assigned to the sub user itself
      - `id` integer, required — unique identifier of the policy
      - `name` string, required — the name of the policy
    - `connector_display_name` string, nullable, required — the display name of the Connector the sub user was issued for. Not recorded yet, so always `null` for now
    - `created_at` string, date-time, required — when the sub user was created
    - `credential_count` integer, required — how many live credentials (enabled, unexpired apikeys and unrevoked OAuth tokens) the sub user owns
    - `effective_policies` SubUserPolicy[], required — the policies the sub user can actually exercise: its assigned policies minus anything its parent user does not hold itself
      - `id` integer, required — unique identifier of the policy
      - `name` string, required — the name of the policy
    - `email` string, required — the synthetic, non-deliverable email of the sub user
    - `name` string, required — the display name of the sub user
    - `parent_user` union, required — the user the sub user derives from. `null` when the parent link no longer resolves
      - object, nullable
      - SubUserParentReference — Minimal information on the parent user of a sub user
        - `id` integer, required — unique identifier of the user
        - `email` string, required — the email of the user
        - `name` string, required — the display name of the user

---

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