Skip to main content
GET
/
analytics
/
ltv
Get LTV analytics data
curl --request GET \
  --url https://api.qonversion.io/v4/analytics/ltv \
  --header 'Authorization: Bearer <token>'
{
  "object": "analytics_ltv",
  "url": "/v4/analytics/ltv",
  "mode": "by_days",
  "cohort_from": 1769000695,
  "cohort_to": 1776816000,
  "cohort_users": 4542,
  "paying_users": 0,
  "revenue_type": "gross",
  "currency": "USD",
  "measure": "usd",
  "segment": null,
  "segments": [],
  "series": []
}

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

​
cohort_from
integer<int64>

Cohort-range start (Unix timestamp, seconds). Defaults to now - 90 days.

​
cohort_to
integer<int64>

Cohort-range end (Unix timestamp, seconds). Defaults to the current time.

​
mode
enum<string>
default:by_days
Available options:
by_days,
by_renewals
​
environment
enum<integer>
default:1
Available options:
0,
1
​
segment
string

Optional attribute to split the LTV curve into per-value series. Allowed values come from GET /v4/analytics/ltv/meta (segmentations[].code).

​
revenue_type
enum<string>
default:gross
Available options:
gross,
net
​
currency
string
default:USD

ISO 4217 currency code. Defaults to USD.

Pattern: ^[A-Z]{3}$
​
filter[<attribute>][]
string[]

Attribute-scoped filter. Allowed attribute codes come from GET /v4/analytics/ltv/meta (filter_conditions[].attribute).

Response

LTV curves.

​
object
enum<string>
required
Available options:
analytics_ltv
​
url
string
required
​
mode
enum<string>
required
Available options:
by_days,
by_renewals
​
cohort_from
integer<int64>
required
​
cohort_to
integer<int64>
required
​
cohort_users
integer
required

Total users in the selected cohort range.

​
paying_users
integer
required

Subset of cohort_users that made at least one paid transaction.

​
revenue_type
enum<string>
required
Available options:
gross,
net
​
currency
string
required
​
measure
enum<string>
required
Available options:
usd
​
series
object[]
required
​
segment
string | null

Segmentation attribute used, if any.

​
segments
object[]

Per-segmentation-value series breakdown. Empty when segment is null.