List offerings

curl --request GET \
  --url https://api.qonversion.io/v4/offerings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.qonversion.io/v4/offerings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.qonversion.io/v4/offerings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://api.qonversion.io/v4/offerings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qonversion.io/v4/offerings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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
}

GET

offerings

List offerings

curl --request GET \
  --url https://api.qonversion.io/v4/offerings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.qonversion.io/v4/offerings', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.qonversion.io/v4/offerings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://api.qonversion.io/v4/offerings")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.qonversion.io/v4/offerings"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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

Show child attributes

has_more

boolean

required

next_cursor

string | null

Maximum string length: 64

Pattern: ^[a-zA-Z0-9._:\- ]+$

REST API v3

REST API v4

Analytics API

List offerings

Authorizations

Query Parameters

Response