---
title: "List of all groups and associated users belonging to each group"
method: GET
path: "/group/list"
tags: ["group"]
---

# List of all groups and associated users belonging to each group

`GET /group/list`

Retrieves organizational groups with associated user information. Returns groups accessible to the authenticated user along with user assignments for each group. Supports pagination and filtering.

## Query parameters

- `limit` integer
- `offset` integer
- `filter` string[]

## Response `200`

Groups with associated user assignments

- OrgUnitListResponse[]
  - `group_id` integer — Organization unit (group) ID the call/record belongs to. Integer. Used to scope data; see /group/list for available group IDs.
  - `group_ext_id` string — A user defined external identifier for the group. Type: string.
  - `group_name` string, required — Human-readable name of the organization unit/group. String.
  - `group_parent_id` integer — The unique ID for the group that would be a parent to the current group. Type: integer (int32).
  - `top_group_id` integer — The unique ID for the top level group associated with current group. Type: integer (int32).
  - `billing_id` integer — The unique ID for the group that is the billing node. Type: integer (int32).
  - `address` string — Caller's street address. String.
  - `city` string — Caller's city (from caller-ID/location lookup). String.
  - `state` string — Caller's state (from caller-ID/location lookup). String (two-letter US state code).
  - `zip` string — The zip code for the group. Type: string.
  - `phone_number` string — Phone number as a string of digits. Typically 10 digits for US numbers.
  - `group_created` string, date — The date and time when the group was created. Type: string (date).
  - `group_modified` string, date-time — The date and time when the group was last updated. Type: string (date-time).
  - `industry_id` integer — The unique identifier for the industry selected. Type: integer (int32).
  - `industry_name` string — The name of the industry selected. Type: string.

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/convirza/apis/convirza-apis.md) · [All operations](https://skmtc.net/convirza/apis/convirza-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/convirza/convirza-apis/versions/ccf9bbe34f5a/schema)