---
title: "Get LTV analytics data"
method: GET
path: "/analytics/ltv"
tags: ["Analytics"]
---

# Get LTV analytics data

`GET /analytics/ltv`

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.

## Query parameters

- `cohort_from` integer
- `cohort_to` integer
- `mode` 'by_days' | 'by_renewals'
- `environment` 0 | 1
- `segment` string
- `revenue_type` 'gross' | 'net'
- `currency` string
- `filter[<attribute>][]` string[]

## Response `200`

LTV curves.

- V4AnalyticsLtv
  - `object` 'analytics_ltv', required
  - `url` string, required
  - `mode` 'by_days' | 'by_renewals', required
  - `cohort_from` integer, required
  - `cohort_to` integer, 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` 'gross' | 'net', required
  - `currency` string, required
  - `measure` 'usd', required
  - `segment` string, nullable — Segmentation attribute used, if any.
  - `segments` object[] — Per-segmentation-value series breakdown. Empty when `segment` is null.
  - `series` V4AnalyticsSeriesDataPoint[], required
    - `start_time` integer, required — Bucket start (Unix seconds).
    - `value` number, double, required — Metric value in the chart's `measure` unit.

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized
- `403` — Insufficient permissions
- `404` — Not found
- `429` — Too many requests
- `500` — Internal error
- `502` — Upstream service failure
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)