App Store Connect Configurations V25

App User Erasures V24

Application Webapp Origins V23

Assets V26

Audit Logs V22

Campaigns V234

Chart Annotations5

Charts V28

CLI Agent V22

Custom Store Events1

Custom Stores8

Demand Score V23

Entitlements V28

Events V24

Google Play V28

Grants V21

Imports1

Integration Event Names (Service)1

Me V25

Notifications1

Onboarding V21

Organization Access V211

Organizations V22

Paywall Resolver (Public)2

Paywall Templates (Public)1

Paywalls V217

Products V211

Project Auth V26

Project Transfers V27

Projects V224

Query V22

Retention Configurations V212

Retention Default Messages V29

Retention Messages V211

Retention Messaging Onboarding V28

retentionCampaignsV29

RevenueCat V1 (compatible)1

RevenueCat V2 (compatible)4

Stripe Customer Links V21

Surveys V212

Users V214

Users V34

Web2App Integrations V25

Webhooks V212

WorkOS Organization Admin1

Paywall Resolver (Public)

Resolve Paywall by ID

Changed on Oct 29, 2026

Returns the identifier and name for a paywall id, scoped to the application in the caller's preview capability (sat_ or API-minted pvt_), sent as Authorization: Bearer <token>. Returns 404 if the token is missing/invalid or the paywall does not belong to that application.

get/v2/paywalls/resolve

Request

Base URL
https://api.superwall.com
URL
https://api.superwall.com/v2/paywalls/resolve
Auth
none required

Query parameters

idstring required

Response

Success

idstring required

identifierstring required

URL-safe identifier (slug) for the paywall

namestring required

Display name of the paywall

application_idstring required

Changes

Oct 29, 2026778a11cd2c15 Revision changes
- warning
  added the new credentials_missing enum value to the / response property for the response status
- warning
  added the new credentials_missing enum value to the / response property for the response status
Sep 9, 2026217c96dc9a29 Revision changes
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- breaking
  the response's property type changed from string to no type for status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  added subschema #1 to the response property anyOf list for the response status
- info
  removed the api_error enum value from the response property for the response status
- info
  removed the api_error enum value from the response property for the response status
- info
  removed the authentication_error enum value from the response property for the response status
- info
  removed the authentication_error enum value from the response property for the response status
- info
  removed the authentication_failed enum value from the response property for the response status
- info
  removed the authentication_failed enum value from the response property for the response status
- info
  removed the idempotency_key_in_use enum value from the response property for the response status
- info
  removed the idempotency_key_in_use enum value from the response property for the response status
- info
  removed the insufficient_permissions enum value from the response property for the response status
- info
  removed the insufficient_permissions enum value from the response property for the response status
- info
  removed the internal_error enum value from the response property for the response status
- info
  removed the internal_error enum value from the response property for the response status
- info
  removed the invalid_api_key enum value from the response property for the response status
- info
  removed the invalid_api_key enum value from the response property for the response status
- info
  removed the invalid_api_key_format enum value from the response property for the response status
- info
  removed the invalid_api_key_format enum value from the response property for the response status
- info
  removed the invalid_reference enum value from the response property for the response status
- info
  removed the invalid_reference enum value from the response property for the response status
- info
  removed the invalid_request_error enum value from the response property for the response status
- info
  removed the invalid_request_error enum value from the response property for the response status
- info
  removed the invalid_session enum value from the response property for the response status
- info
  removed the invalid_session enum value from the response property for the response status
- info
  removed the missing_api_key enum value from the response property for the response status
- info
  removed the missing_api_key enum value from the response property for the response status
- info
  removed the organization_required enum value from the response property for the response status
- info
  removed the organization_required enum value from the response property for the response status
- info
  removed the parameter_invalid enum value from the response property for the response status
- info
  removed the parameter_invalid enum value from the response property for the response status
- info
  removed the parameter_missing enum value from the response property for the response status
- info
  removed the parameter_missing enum value from the response property for the response status
- info
  removed the parameter_unknown enum value from the response property for the response status
- info
  removed the parameter_unknown enum value from the response property for the response status
- info
  removed the permission_error enum value from the response property for the response status
- info
  removed the permission_error enum value from the response property for the response status
- info
  removed the rate_limit_error enum value from the response property for the response status
- info
  removed the rate_limit_error enum value from the response property for the response status
- info
  removed the rate_limit_exceeded enum value from the response property for the response status
- info
  removed the rate_limit_exceeded enum value from the response property for the response status
- info
  removed the resource_already_exists enum value from the response property for the response status
- info
  removed the resource_already_exists enum value from the response property for the response status
- info
  removed the resource_archived enum value from the response property for the response status
- info
  removed the resource_archived enum value from the response property for the response status
- info
  removed the resource_missing enum value from the response property for the response status
- info
  removed the resource_missing enum value from the response property for the response status
- info
  removed the side_effect_failed enum value from the response property for the response status
- info
  removed the side_effect_failed enum value from the response property for the response status
- info
  removed the unsupported_operation enum value from the response property for the response status
- info
  removed the unsupported_operation enum value from the response property for the response status
- info
  removed the upstream_service_error enum value from the response property for the response status
- info
  removed the upstream_service_error enum value from the response property for the response status
This list may be incomplete.

Operation history

Resolve Paywall by ID

Request

Query parameters

Response 200OK

Changes

Response