---
title: "List groups"
method: GET
path: "/api/sites/multiscreen/{site_name}/membership/groups"
tags: ["Groups API"]
---

# List groups

`GET /api/sites/multiscreen/{site_name}/membership/groups`

## Request

- Base URL: `https://api.duda.co`
- URL: `https://api.duda.co/api/sites/multiscreen/{site_name}/membership/groups`
- Auth: HTTP basic

Returns a page of membership groups for the site.

## Path parameters

- `site_name` string, required

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

OK

- CursorPageResponseMembershipGroupResponse
  - `cursor` string, nullable: Cursor provided in request
  - `limit` integer: Paging limit evaluated for request
  - `next_page` string, nullable: Cursor value for querying next page
  - `results` MembershipGroupResponse[]: Entities of requested page
    - `id` string
    - `name` string, required: Group name, as displayed in UI
    - `pages` string[]: List of page uuids to be protected by this group When pages is assigned to a group, it means that site member requires authority/permission 'ACCESS_PAGE_{page-uuid}' to access this page. Authority is granted to site member if he belongs to this group or if this authority is granted to him by identity provider.
  - `site_name` string: Owning site
  - `total_responses` integer: Total number of entities in for given site

## Other responses

- `400`: Bad request. The request is malformed or failed validation.
- `401`: Unauthorized. The credentials are missing or invalid.
- `429`: Too many requests. The rate limit was exceeded.

---

[API](https://skmtc.dev/duda/apis/duda-partner-api.md) - [All operations](https://skmtc.dev/duda/apis/duda-partner-api/llms.txt) - [OpenAPI document](https://skmtc.dev/duda/apis/duda-partner-api/revisions/52be4d41cb12?raw)