---
title: "List mailing lists"
method: GET
path: "/v1/lists"
tags: ["Mailing lists"]
---

# List mailing lists

`GET /v1/lists`

Retrieve a list of your account's mailing lists.

## Response `200`

Successful.

- MailingList[]
  - `id` string, required — The ID of the mailing list.
  - `name` string, required — The name of the mailing list.
  - `description` string, nullable, required — The description of the mailing list. `null` if no description is set.
  - `isPublic` boolean, required — Whether the mailing list is public (`true`) or private (`false`).

## Other responses

- `405` — Wrong HTTP request method.

## Changes

> 9 revisions in range; 1 not diffed, 2 could not be searched.

- **2026-07-21** `df77516a130a` — 1 breaking
  - the response property `items/description` became nullable for the status `200`

[Change history](https://skmtc.dev/loops/apis/loops-openapi-spec/changes/v1/lists/get.md)

---

[API](https://skmtc.dev/loops/apis/loops-openapi-spec.md) · [All operations](https://skmtc.dev/loops/apis/loops-openapi-spec/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loops/loops-openapi-spec/revisions/8bd0098300ec/schema)