Skip to main content
GET
/
analytics
/
cohorts
/
meta
Get cohort analytics metadata
curl --request GET \
  --url https://api.qonversion.io/v4/analytics/cohorts/meta \
  --header 'Authorization: Bearer <token>'
{
  "object": "analytics_cohorts_meta",
  "url": "/v4/analytics/cohorts/meta",
  "modes": [
    {
      "code": "by_renewals",
      "label": "By Renewals"
    },
    {
      "code": "by_days",
      "label": "By Days"
    }
  ],
  "groupings": [
    {
      "code": "day",
      "label": "Day"
    },
    {
      "code": "week",
      "label": "Week"
    },
    {
      "code": "month",
      "label": "Month"
    },
    {
      "code": "quarter",
      "label": "Quarter"
    },
    {
      "code": "year",
      "label": "Year"
    }
  ],
  "metrics": [
    {
      "code": "revenue",
      "label": "Revenue"
    },
    {
      "code": "subscriptions",
      "label": "Subscriptions"
    },
    {
      "code": "payers",
      "label": "Payers"
    },
    {
      "code": "arpu",
      "label": "ARPU"
    },
    {
      "code": "arppu",
      "label": "ARPPU"
    }
  ],
  "definitions": [
    {
      "code": "new_customers",
      "label": "New Customers"
    },
    {
      "code": "initial_conversions",
      "label": "Initial Conversions"
    },
    {
      "code": "new_paying",
      "label": "New Paying Customers"
    }
  ],
  "filter_conditions": [
    {
      "attribute": "target_platform",
      "label": "Store",
      "persistent": true,
      "type": "list",
      "values": [
        {
          "code": "iOS",
          "label": "Apple App Store"
        },
        {
          "code": "Android",
          "label": "Google Play"
        },
        {
          "code": "Stripe",
          "label": "Stripe"
        }
      ]
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://documentation.qonversion.io/llms.txt

Use this file to discover all available pages before exploring further.

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

​
from
integer<int64>
​
to
integer<int64>
​
environment
enum<integer>
default:1
Available options:
0,
1

Response

Cohort metadata.

​
object
enum<string>
required
Available options:
analytics_cohorts_meta
​
url
string
required
​
modes
object[]
required
​
groupings
object[]
required
​
metrics
object[]
required

Allowed metric values. (Metric selection is chosen client-side — the endpoint returns all five.)

​
definitions
object[]
required
​
filter_conditions
object[]
required