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

# List members

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

## Request

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

Returns a page of members for the site, optionally filtered by email, group id, and status.

## Path parameters

- `site_name` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `email` string
- `group_id` string
- `status` string[]

## Response `200`

OK

- CursorPageResponseApiMemberResponse
  - `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` ApiMemberResponse[]: Entities of requested page
    - `email` string: The member's email
    - `first_name` string: The member's first name
    - `groups` ApiGroupRelationResponse[]: The member's groups
      - `id` string: Group id
      - `name` string: Name of the group
    - `id` string: The member's id within the site
    - `last_login` string: The member's last login ISO date-time
    - `last_name` string: The member's last name
    - `registered` string: The member's registered ISO date-time
    - `status` 'PENDING' | 'ACTIVE' | 'UNAUTHORIZED': The member's status: - PENDING: Site owner did not yet approve the member (for approval-based membership), the member will not have access to any protected site pages - ACTIVE: Membership is approved, the member has some access to protected site pages - UNAUTHORIZED: Indicates that members count limit was reached for the site, the member will not have access to any protected site pages
  - `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)