v1

latestOpenAPI 3.0.32026-07-26120117318.1 KB

Analytics

Get LTV analytics data

Returns lifetime-value curves for cohorts in the requested range. series is a list of time-indexed revenue (or ARPU / ARPPU) points; segment + segments let you split the curve by an attribute.

get/analytics/ltv

Query parameters

cohort_frominteger

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

cohort_tointeger

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

mode'by_days' | 'by_renewals'

environment0 | 1

segmentstring

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

revenue_type'gross' | 'net'

currencystring

ISO 4217 currency code. Defaults to USD.

filter[<attribute>][]string[]

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

Response

LTV curves.

object'analytics_ltv' required

urlstring required

mode'by_days' | 'by_renewals' required

cohort_frominteger required

cohort_tointeger required

cohort_usersinteger required

Total users in the selected cohort range.

paying_usersinteger required

Subset of cohort_users that made at least one paid transaction.

revenue_type'gross' | 'net' required

currencystring required

measure'usd' required

segmentstring nullable

Segmentation attribute used, if any.

segmentsobject[]

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