Skip to main content
GET
Get LTV analytics data

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.