Skip to main content
GET
/
offerings
List offerings
curl --request GET \
  --url https://api.qonversion.io/v4/offerings \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "url": "/v4/offerings",
  "data": [
    {
      "object": "offering",
      "id": "premium_monthly",
      "url": "/v4/offerings/premium_monthly",
      "tag": 1,
      "product_ids": [
        "premium_monthly_799",
        "premium_annual_4999"
      ],
      "created_at": "2025-09-15T12:30:00Z",
      "updated_at": "2025-11-03T10:26:40Z"
    },
    {
      "object": "offering",
      "id": "winback",
      "url": "/v4/offerings/winback",
      "tag": 0,
      "product_ids": [
        "premium_annual_2999"
      ],
      "created_at": "2025-10-02T09:15:00Z",
      "updated_at": "2025-10-02T09:15:00Z"
    }
  ],
  "has_more": false
}

Authorizations

​
Authorization
string
header
required

Bearer authentication using the project Secret Key (prefixed with sk_, or test_sk_ for sandbox). All v4 public endpoints require the Secret Key — see Authentication. Never expose the Secret Key in client-side code.

Query Parameters

​
limit
integer
default:20
Required range: 1 <= x <= 100
​
starting_after
string

Cursor for pagination. Pass the id of the last offering from the previous page. If the referenced offering no longer exists the server restarts pagination from the first row and emits an X-Qon-Pagination-Restarted: true response header.

Maximum string length: 64
Pattern: ^[a-zA-Z0-9._:\- ]+$

Response

A paginated list of offerings.

​
object
enum<string>
required
Available options:
list
​
url
string
required
Example:

"/v4/offerings"

​
data
object[]
required
​
has_more
boolean
required
​
next_cursor
string | null
Maximum string length: 64
Pattern: ^[a-zA-Z0-9._:\- ]+$