> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fype.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Analytics

# SaaS Subscription Analytics

Fype compiles billing data, cycle events, and cancellations automatically to render real-time SaaS financial performance metrics.

***

## Core SaaS Metrics

Fype's analytics pipeline computes financial performance across several endpoints:

### 1. Monthly Recurring Revenue (MRR)

MRR represents the normalized monthly recurring revenue from active subscriptions.

* **Endpoint**: `GET /analytics/mrr`
* **Computed Components**:
  * **New MRR**: Revenue added by new customers.
  * **Expansion MRR**: Revenue gained from plan upgrades.
  * **Contraction MRR**: Revenue lost from plan downgrades.
  * **Churn MRR**: Revenue lost due to subscription cancellations.

### 2. Subscription Churn

Churn measures the rate at which customers cancel or pause their subscriptions.

* **Endpoint**: `GET /analytics/churn`
* **Output**: Calculates the logo churn rate (number of subscriptions lost) and revenue churn rate (percentage of MRR lost) for active billing periods.

### 3. Customer Lifetime Value (LTV)

LTV estimates the total revenue you can expect from a single customer account during their relationship with your business.

* **Endpoint**: `GET /analytics/ltv`
* **Formula**:
  $\text{LTV} = \frac{\text{Average Revenue Per User (ARPU)}}{\text{User Churn Rate}}$

### 4. SaaS Quick Ratio

Measures your business growth efficiency by comparing MRR growth against MRR losses.

* **Endpoint**: `GET /analytics/quick-ratio`
* **Formula**:
  $\text{Quick Ratio} = \frac{\text{New MRR} + \text{Expansion MRR}}{\text{Contraction MRR} + \text{Churn MRR}}$
* **Interpretation**: A ratio greater than **4.0** indicates efficient, healthy subscription growth.

### 5. Autopay Mandate Analytics

Tracks checkout success and recurring debit success rates.

* **Endpoint**: `GET /analytics/autopay`
* **Output**: Displays authorization success rates for UPI Autopay vs. Credit Cards, mandate failure reasons, and real-time bank health success rates.

***

## Cohort Retention Heatmaps

Fype groups customers into weekly or monthly cohorts based on their activation date and tracks how long they remain subscribed.

* **Endpoint**: `GET /analytics/cohorts`
* **Visual Representation**: Used by the Fype dashboard to render cohort retention heatmaps:

```
+------------+------------+---------+---------+---------+---------+
| COHORT     | USERS      | MONTH 1 | MONTH 2 | MONTH 3 | MONTH 4 |
+------------+------------+---------+---------+---------+---------+
| Jan 2026   | 100        | 100%    | 85%     | 78%     | 70%     |
| Feb 2026   | 120        | 100%    | 88%     | 80%     | -       |
| Mar 2026   | 150        | 100%    | 90%     | -       | -       |
+------------+------------+---------+---------+---------+---------+
```

These analytics allow you to spot drop-off points, trace product adoption trends, and verify customer retention patterns easily.
