---
title: "Get a group by ID"
method: GET
path: "/groups/{groupId}"
tags: ["groups"]
---

# Get a group by ID

`GET /groups/{groupId}`

Retrieves detailed information about a specific call group, including its members, ring strategy, ring durations, and IVR assignments. Use this to inspect a group's configuration before making changes (e.g., adding/removing members, modifying ring duration).

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

**Monitoring impact:**
- **OFF:** Returns the group only if **you are a member** of it. Returns `404` otherwise.
- **ON:** Returns **any group** in the team regardless of your membership.

**Member pagination:** `limit_count` and `limit_offset` paginate **only the `users` sub-array** (group members) of the response — they do not affect the group object itself. The response does not include a total member count: keep incrementing `limit_offset` until an empty `users` array is returned.

## Path parameters

- `groupId` integer, required

## Query parameters

- `limit_count` integer
- `limit_offset` integer

## Response `200`

Successful operation

- GroupFull
  - `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
  - `users` GroupUser[], nullable — The list of campaign sms
    - `user_id` integer — The user identifier
    - `team_id` integer — The team identifier of the user
    - `initial` string — The initials of the user
    - `color` string
    - `firstname` string — The firstname of the user
    - `lastname` string — The lastname of the user
    - `company` string — The company of the user
    - `email` string — The email of the user
    - `picture` string — The picture of the user
    - `concat_name` string
    - `ring_duration` integer — Ring duration when an IVR incoming call append
    - `order` integer — The order in the ivr queue

## Other responses

- `400` — The provided group ID is invalid
- `401` — Authentication token is missing, invalid, or expired
- `404` — No group found with the specified ID (or you do not have access to it without monitoring)
- `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)