---
title: "Get Group Users"
method: GET
path: "/api/v1/admin/groups/{group_id}/users"
tags: ["Admin APIs", "groups"]
---

# Get Group Users

`GET /api/v1/admin/groups/{group_id}/users`

Get users in a group.

## Path parameters

- `group_id` string, required

## Response `200`

Successful Response

- UserRead[]
  - `email` string, required
  - `first_name` string, required
  - `last_name` string, required
  - `transaction_limit` number, nullable
  - `allocated_amount` number, nullable
  - `id` string, uuid4, required
  - `okta_user_id` string, required
  - `client_id` string, uuid4, required
  - `extra_profile_data` object, nullable
  - `is_active` boolean, required
  - `billing_owner` boolean, required
  - `plan_tier` string
  - `current_consumption` number, nullable
  - `mcp_daily_limit` number, nullable
  - `role_id` string, uuid4, nullable
  - `role_name` string, nullable
  - `block_role` 'block_user' | 'block_admin' — Additive Block role values stored directly on ``users.block_role`` and ``groups.block_role`` (``block_role_enum`` Postgres enum). Matches the snake_case value set used elsewhere in the Block domain.
  - `distributor_role` 'Distributor Admin' | 'Distributor User' — Additive distributor role stored directly on ``users.distributor_role`` (``distributor_role_enum`` Postgres enum), the same pattern as ``block_role``. ``DISTRIBUTOR_ADMIN`` grants access to the platform's distributor features, scoped by the user's client's distributor contract(s); ``DISTRIBUTOR_USER`` marks a non-administrative distributor user and grants no distributor-view access on its own.
  - `prompt_access` boolean
  - `group_id` string, uuid4, nullable
  - `group_name` string, nullable
  - `group_mcp_period_limit` number, nullable
  - `client_name` string, nullable
  - `status` string, nullable
  - `data_collection_consent` 'granted' | 'not-granted', nullable
  - `terms` UserLegalTabSignupTOUResponse — Schema for displaying TOU acceptance info in the admin portal user legal tab.
    - `id` string, uuid, nullable
    - `content` string, nullable
    - `effective_at` string, date-time, nullable
    - `version_num` integer, nullable
    - `has_accepted_current` boolean, required
    - `accepted_at` string, date-time, nullable
    - `first_revision_published_at` string, date-time, nullable
    - `current_version_id` string, uuid, nullable
    - `current_version_num` integer, nullable
    - `current_version_first_revision_published_at` string, date-time, nullable
  - `deleted_at` string, date-time, nullable
  - `deletion_reason` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api.md) · [All operations](https://skmtc.net/carbonarc/apis/carbon-arc-client-admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carbonarc/carbon-arc-client-admin-api/revisions/a8ca30023371/schema)