---
title: "List groups"
method: GET
path: "/groups"
tags: ["groups"]
---

# List groups

`GET /groups`

Retrieves call groups (ring groups) configured for your team. Groups define how incoming calls are distributed among a set of users (simultaneous ring, round-robin, etc.). Each group includes its member list, ring strategy, and configuration.

**Permission:** No specific permission required. A valid API key is sufficient.

**Monitoring impact:**
- **OFF:** Returns only the groups **you belong to** as a member.
- **ON:** Returns **all groups** in the team, regardless of your membership.

**Pagination:** Results are returned in a **stable order** (by group id), so the same offset always yields the same page. To read every group, keep `limit_count` fixed and increase `limit_offset` by that amount on each request — this avoids the duplicates and gaps you would get from an unordered list.

## Query parameters

- `limit_count` integer
- `limit_offset` integer

## Response `200`

Successful operation

- GroupList
  - `list_count` integer — The size of the list
  - `list` GroupLight[]
    - `group_id` integer — The identifier of the group
    - `name` string — The name of the group
    - `total_users_count` integer — The number of users in the group
    - `color` string
    - `is_jumper` boolean — Allow users to jump into

## Other responses

- `400` — A request parameter is malformed or missing
- `401` — Authentication token is missing, invalid, or expired
- `500` — Internal server error

---

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