---
title: "List paywalls"
method: GET
path: "/api/v2/server-side-api/paywalls/"
tags: ["Paywalls"]
---

# List paywalls

`GET /api/v2/server-side-api/paywalls/`

Retrieves a list of paywalls in your app.

## Query parameters

- `page[number]` integer
- `page[size]` integer

## Response `200`

Paywalls retrieved successfully

- PaywallListResponse
  - `data` PaywallListItem[], required — Array of paywall objects
    - `title` string, required — The name of the paywall, as defined in your Adapty Dashboard
    - `paywall_id` string, uuid, required — The unique identifier of the paywall
    - `use_paywall_builder` boolean, required — Whether the paywall uses the paywall builder
    - `use_paywall_builder_legacy` boolean, required — Whether the paywall uses the legacy paywall builder
    - `updated_at` string, date-time, required — Timestamp when the paywall was last updated
    - `created_at` string, date-time, required — Timestamp when the paywall was created
    - `state` 'draft' | 'live' | 'inactive' | 'archived', required — The current state of the paywall
    - `is_deleted` boolean, required — Whether the paywall is marked as deleted
    - `web_purchase_url` string, uri, nullable — URL for web purchases, if applicable
    - `products` object[], required — Array of product objects containing product information for the paywall
      - `product_id` string, uuid, required — The unique identifier of the product
      - `title` string, required — The title of the product
      - `product_set` 'weekly' | 'monthly' | 'trimonthly' | 'semiannual' | 'annual' | 'lifetime' | 'uncategorised' | 'nonsubscriptions' | 'two_months' | 'consumable', required — The product set category
      - `offer` object, nullable, required
        - `product_offer_id` string, uuid, required — The unique identifier of the product offer
        - `title` string, required — The title of the offer
  - `meta` object, required
    - `pagination` object, required
      - `count` integer, required — Total number of paywalls
      - `page` integer, required — Current page number
      - `pages` integer, required — Total number of pages

## Other responses

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

---

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