---
title: "Get paywall versions with view URLs"
method: GET
path: "/paywalls/{paywallId}/versions"
---

# Get paywall versions with view URLs

`GET /paywalls/{paywallId}/versions`

Retrieve all stored versions of the paywall (including the current one) with
usage statistics from ClickHouse and a public URL to preview every version on
the project domain. Each entry contains a `view_url` ready to open in the
browser.

## Path parameters

- `paywallId` integer, required — Paywall identifier

## Headers

- `api_key` string, required

## Response `200`

Paywall versions list retrieved successfully

- object
  - `success` integer
  - `paywall_id` integer
  - `current_version` integer, nullable — Latest stored version of the paywall
  - `published_version` integer, nullable — Version currently served to end users
  - `versions` object[] — All paywall versions ordered from oldest to newest
    - `version` integer — Version number
    - `date` string, date-time — Date when this version was created
    - `source` string, nullable — Origin of the change (`web`, `api`, etc.)
    - `client_id` integer, nullable — Cabinet user ID that produced the version (if any)
    - `is_current` boolean — Whether this version is the latest stored version
    - `is_published` boolean — Whether this version is currently published
    - `first_event_date` string, date-time, nullable — Date of first user event for this version
    - `last_event_date` string, date-time, nullable — Date of last user event for this version
    - `count_users` integer — Number of unique users who interacted with this version
    - `view_url` string, uri, nullable — Signed public URL to preview this specific paywall version on the project domain. Includes the version number and a hash of the version date, plus `edit_mode=1` so the preview bypasses cached published content.

## Other responses

- `404` — Paywall not found in current project

---

[API](https://skmtc.net/web2wave/apis/web2wave-api.md) · [All operations](https://skmtc.net/web2wave/apis/web2wave-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/web2wave/web2wave-api/revisions/c88545119271/schema)