> ## 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.

# Analytics

> Charts, cards, cohorts, LTV, and insights

The **Analytics API** exposes the same data that powers the Qonversion dashboard: time-series charts, KPI cards, cohort tables, LTV curves, and narrative insights. Every endpoint supports filtering by currency, date range, and segment where applicable.

## Key concepts

* **Chart codes** — Stable string identifiers for each chart. 25 public codes covering revenue (`proceeds`, `sales`, `refunds`, `refund-rate`, `arpu`, `arppu`), recurring revenue (`mrr`, `arr`, `mrr-movement`, `arr-movement`), subscriptions (`active-subscriptions`, `new-subscriptions`, `paid-subscriptions-movement`, `subscriptions-overview`, `subscription-cancellation`), trials (`free-trials`, `active-trials`, `trials-movement`, `trial-cancellation`, `trial-to-paid`), and acquisition (`users-overview`, `user-to-trial`, `user-to-paid`). Plus back-compat aliases `user-to-trial-conversion` and `subscription-cancellation-rate`. The `chart_code` parameter on `GET /v4/analytics/charts/{chart_code}` (below) has the full machine-readable enum; use `GET /v4/analytics/charts/{chart_code}/meta` to discover available segmentation/filter codes for a given chart.
* **Realtime card** — `/v4/analytics/cards/realtime` returns today-so-far counters (trials, subscriptions, in-app purchases, tracked revenue) alongside the corresponding values at the same point yesterday. Surfaces in the dashboard header.
* **Cohorts** — Retention / conversion cohort matrices. Use `/v4/analytics/cohorts/meta` to discover available dimensions.
* **LTV** — Revenue LTV and trial-to-paid conversion LTV are separate endpoints.
* **Insights** — Pre-computed narrative insights surfaced on the dashboard home screen, including scalar KPIs (MRR, sales, proceeds, new users) plus AI-written observations.

## Available endpoints

| Method | Endpoint                              | Description                             | Status |
| ------ | ------------------------------------- | --------------------------------------- | ------ |
| GET    | `/analytics/cards/realtime`           | Today-so-far vs. yesterday counters     | New    |
| GET    | `/analytics/charts/{chart_code}`      | Get analytics chart data                | New    |
| GET    | `/analytics/charts/{chart_code}/meta` | Get analytics chart metadata            | New    |
| GET    | `/analytics/cohorts`                  | Get cohort analytics data               | New    |
| GET    | `/analytics/cohorts/meta`             | Get cohort analytics metadata           | New    |
| GET    | `/analytics/currencies`               | Get supported analytics currencies      | New    |
| GET    | `/analytics/insights`                 | Get analytics insights                  | New    |
| GET    | `/analytics/ltv`                      | Get LTV analytics data                  | New    |
| GET    | `/analytics/ltv/meta`                 | Get LTV analytics metadata              | New    |
| GET    | `/analytics/ltv/trial-conversion`     | Get LTV trial-conversion analytics data | New    |

## Authentication

All v4 endpoints require a **Secret Key**. See [Authentication](/reference/v4/authentication).