---
title: "Get list of groups"
method: GET
path: "/groups"
tags: ["Groups"]
---

# Get list of groups

`GET /groups`

Retrieves a paginated list of groups.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Returns a paginated list of groups.

- GetGroupsResponse
  - `limit` integer — The number of items that are returned per page
  - `offset` integer — The offset used for pagination.
  - `total` integer — The total number of elements across all pages.
  - `data` Group[]
    - `name` string, required — The group's name.
    - `type` 'general' | 'administrators' | 'end-users', required — The group type.
    - `supportLevel` integer — A number representing the support level (from existing support levels).
    - `companyId` integer, nullable — The unique identifier for the company associated with the group.
    - `email` string, email — The email address associated with the group.
    - `receiveAutomaticSrEmailNotifications` boolean — Indicates whether the group receives automatic SR email notifications.
    - `canBeAssignedToServiceRecord` boolean — Indicates if the group can be assigned to a service record. Not applicable if `type` is set to `END_USERS`.
    - `enableAutomaticDispatchOfServiceRecords` boolean — Determines if service records should be automatically dispatched. Only applicable if `canBeAssignedToServiceRecord` is `true`
    - `id` integer, required — The unique identifier of the group.

## Other responses

- `400` — The request was invalid or cannot be served
- `401` — Authentication information is missing or invalid

---

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