---
title: "List every subscriber list an email can manage, with its current status on each"
method: GET
path: "/v1/projectId/{projectId}/subscriber-lists/public/{email}"
tags: ["Subscriber Lists"]
---

# List every subscriber list an email can manage, with its current status on each

`GET /v1/projectId/{projectId}/subscriber-lists/public/{email}`

## Request

- Base URL: `https://api.bluefox.email`
- URL: `https://api.bluefox.email/v1/projectId/{projectId}/subscriber-lists/public/{email}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

The endpoint behind a subscriber-facing subscription-preferences page: every public list in the project, plus - 
if authenticating with a SubscriptionToken minted for one - the single private list it names, each carrying this 
email's current status (active/paused/unsubscribed) where a subscription exists. Building a custom preferences 
page for this project? See the SubscriptionToken security scheme below for the full flow: take the `token` query 
parameter off the unsubscribe/pause-subscription link, call this endpoint with it to render the page, then 
PATCH/POST the individual subscriber-lists endpoints (same token) as the subscriber makes changes.

## Path parameters

- `projectId` string, required
- `email` string, required

## Response `200`

OK

- object
  - `status` integer
  - `result` object
    - `items` object[]
      - `_id` string
      - `name` string
      - `description` string
      - `private` boolean
      - `subscriber` object: Present only when this email has a subscription (of any status) on this list.
        - `email` string
        - `status` 'unverified' | 'active' | 'unsubscribed' | 'paused'
        - `pausedUntil` string, date-time
    - `count` integer
    - `logoUrl` string

## Other responses

- `403`: Missing or invalid API key
- `404`: Contact, or there are no available subscriber lists not found

---

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