mrr_churn_rate_metrics
Calculate Net MRR Churn Rate metrics to analyze subscription business health by measuring revenue changes from customer churn, contraction, and expansion over time.
Instructions
[ChartMogul API] Retrieve Net MRR Churn Rate metrics as percentage. Net MRR Churn = (Churned MRR + Contraction MRR - Expansion MRR) / MRR at Start × 100. IMPORTANT: Negative values indicate net negative churn (expansion > churn - EXCELLENT!). Normal range typically -10% to +10%. Values can exceed 100% or be very negative (e.g., -300% means MRR quadrupled). Returns entries array with: date (string), mrr_churn_rate (float percentage), mrr_churn_rate_percentage_change (float). Plus summary object. REQUIRED: start_date (YYYY-MM-DD), end_date (YYYY-MM-DD), interval ("day", "week", "month", "quarter", "year"). OPTIONAL: geo, plans, filters (string: CFL syntax field~operator~value~AND~... Use get_cfl_fields for field list). Example: mrr_churn_rate=-5.2 means -5.2% (net negative churn - good!)
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| start_date | Yes | ||
| end_date | Yes | ||
| interval | Yes | ||
| geo | No | ||
| plans | No | ||
| filters | No |