---
title: "ListGroups"
method: GET
path: "/v1alpha/processing-platforms/{platformId}/groups"
tags: ["ProcessingPlatformsService"]
---

# ListGroups

`GET /v1alpha/processing-platforms/{platformId}/groups`

Lists all available user groups for the given platform.

## Path parameters

- `platformId` string, required

## Query parameters

- `pageParameters.skip` integer
- `pageParameters.pageSize` integer
- `pageParameters.pageToken` string

## Response `200`

OK

- ListGroupsResponse
  - `groups` string[]
  - `pageInfo` PageInfo
    - `nextPageToken` string — token for the next page
    - `total` integer — The (estimated) total number of records. If the total is unknown, this value is -1.

## Other responses

- `default` — Default error response

## Changes

- **2024-01-26** `12ea67ec598f` — 2 info
  - added the new optional `query` request parameter `pageParameters.pageToken`
  - added the optional property `pageInfo/nextPageToken` to the response with the `200` status
- **2023-12-19** `df7ee7e702db` — 3 info
  - added the new optional `query` request parameter `pageParameters.pageSize`
  - added the new optional `query` request parameter `pageParameters.skip`
  - added the optional property `pageInfo` to the response with the `200` status
- **2023-11-29** `8ae5870420f4` — 1 info
  - endpoint added
- **2023-11-17** `04d64891152e` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/getstrm/apis/pace-api/changes/v1alpha/processing-platforms/:platformId/groups/get.md)

---

[API](https://skmtc.dev/getstrm/apis/pace-api.md) · [All operations](https://skmtc.dev/getstrm/apis/pace-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getstrm/pace-api/revisions/7102a90e7c1e/schema)