Skip to main content
An Offering is a named bundle of products that the SDK consumes to render a paywall or purchase flow. Offerings decouple the products a user sees from the product IDs in your app code — you can change the contents of an offering without shipping a new build. One offering per project is marked as the main offering and is returned by default to the SDK when no specific ID is requested.

​
Key concepts

  • Offering ID — Stable identifier used by the SDK (e.g., onboarding, winback).
  • Products — An ordered list of products attached to the offering. The SDK renders them in the order you define.
  • Main offering — A single project-level default, promoted via POST /v4/offerings/{offering_id}/set-main.
  • Experiments link — Offerings can be attached to experiment groups to A/B test paywall contents.

​
Available endpoints

MethodEndpointDescriptionStatus
GET/offeringsList offeringsNew
POST/offeringsCreate an offeringNew
GET/offerings/{offering_id}Get an offeringNew
PATCH/offerings/{offering_id}Update an offering (partial)New
DELETE/offerings/{offering_id}Delete an offeringNew
POST/offerings/{offering_id}/set-mainMark this offering as the project’s main offeringNew

​
Authentication

All v4 endpoints require a Secret Key. See Authentication.
These endpoints are live in the api-gateway and the Qonversion MCP server. OpenAPI playground entries will be added in a follow-up once the upstream OpenAPI source is updated.