---
title: "Fetch subscription lists"
method: GET
path: "/subscription_lists"
tags: ["subscription_lists"]
---

# Fetch subscription lists

`GET /subscription_lists`

Return json data about subscription lists

## Response `200`

Subscription lists data

- SubscriptionListsResponse
  - `data` SubscriptionListsResponseData[]
    - `id` string — Subscription list ID
    - `type` 'subscription_list' — Resource type
    - `attributes` SubscriptionListsResponseAttributes
      - `name` string — Name of the subscription list
      - `is_default` boolean — Whether this is the default subscription list
      - `subscriber_count` integer — Number of subscribers in this list
      - `form_id` string — Form ID for use with Paubox Secure Forms

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `500` — Internal server error

---

[API](https://skmtc.dev/paubox/apis/paubox-forms-api.md) · [All operations](https://skmtc.dev/paubox/apis/paubox-forms-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/paubox/paubox-forms-api/revisions/71f6affe238c/schema)