---
title: "Read a list's email guest list"
method: GET
path: "/api/v1/lists/{id}/allowed-emails"
tags: ["lists"]
---

# Read a list's email guest list

`GET /api/v1/lists/{id}/allowed-emails`

## Request

- Base URL: `https://www.listdrop.co`
- URL: `https://www.listdrop.co/api/v1/lists/{id}/allowed-emails`
- Auth: OAuth 2 (authorization code, authorization URL `https://www.listdrop.co/oauth/authorize`, token URL `https://www.listdrop.co/api/oauth/token`, scopes: `lists:read`)

The email addresses allowed to view this private list (see createAgentList's allowed_emails). Owner only: requires an OAuth token belonging to the list's owner.

## Path parameters

- `id` string, required

## Response `200`

The guest list (empty array = not gated).

- AllowedEmails
  - `listId` string, required
  - `emails` string[], required: The current guest list; empty = the list is not email-gated.

## Other responses

- `401`: Missing/invalid bearer token, or missing the lists:read scope.
- `404`: List not found, or the account isn't its owner.

---

[API](https://skmtc.dev/listdrop/apis/listdrop-public-api.md) · [All operations](https://skmtc.dev/listdrop/apis/listdrop-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/listdrop/apis/listdrop-public-api/revisions/699b5367e2f3?raw)