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

# List invitations

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

## Request

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

Returns a page of invitations for the site, optionally filtered by email.

## Path parameters

- `site_name` string, required

## Query parameters

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

## Response `200`

OK

- CursorPageResponseApiInvitationResponse
  - `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` ApiInvitationResponse[]: Entities of requested page
    - `created` string: Invitation creation ISO date-time
    - `email` string: Email associated with the invitation
    - `groups` ApiGroupRelationResponse[]
      - `id` string: Group id
      - `name` string: Name of the group
    - `id` string: Invitation id
  - `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)
