---
title: "GET /api/sales-channels/groups"
method: GET
path: "/api/sales-channels/groups"
tags: ["api", "sales-channels"]
---

# GET /api/sales-channels/groups

`GET /api/sales-channels/groups`

Get all sales channel groups

## Query parameters

- `status` string[] — Filter sales channel groups by status
- `name` string — Filter sales channel groups by name
- `includeDefaultGroups` boolean — Whether default groups should be included
- `top` integer — A limit on the number of objects to be returned. Can range between 1 and 1000.
- `skip` integer — The number of objects to skip for the requested result

## Response `200`

OK

- SalesChannelGroupResource
  - `name` string, required — The name of the sales channel group
  - `status` 'ACTIVE' | 'INACTIVE', required — The status of the sales channel group, whether it is active or not
  - `salesChannelIds` string[] — The sales channels that are in the group
  - `restrictEventAccess` boolean, required — Wether channels in this group can only access some events or all
  - `_id` string, required — The ID of the sales channel group
  - `sellerId` string, required — The ID of the seller of the sales channel group
  - `createdAt` string, date-time — An ISO timestamp indicating when the sales channel group was created
  - `updatedAt` string, date-time — An ISO timestamp indicating when the sales channel group was updated

## Other responses

- `400` — Bad Request
- `401` — Unauthorized

---

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