---
title: "List Paywalls for Preview"
method: GET
path: "/v2/paywalls/preview-list"
tags: ["Paywall Resolver (Public)"]
---

# List Paywalls for Preview

`GET /v2/paywalls/preview-list`

Returns id, identifier and name for non-archived paywalls allowed by the caller's preview capability (sat_ or API-minted pvt_), sent as Authorization: Bearer <token>. Paywall-scoped pvt_ tokens return one item; application-scoped pvt_ tokens enable the full picker. Returns 404 if the token is missing or invalid.

## Response `200`

Success

- object
  - `object` 'list', required
  - `data` object[], required
    - `id` string, required — Numeric paywall database id
    - `identifier` string, required — URL-safe identifier (slug) for the paywall
    - `name` string, required — Display name of the paywall
  - `has_more` boolean, required — True when the application has more paywalls than the returned cap
  - `application_id` string, required — ID of the application these paywalls belong to

## Other responses

- `400` — The request did not match the expected schema
- `404` — The requested resource was not found
- `500` — An unexpected error occurred on the server

---

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