MRR Movements
GET https://api.chartmogul.com/v2/metrics/mrr_movements
Retrieves the MRR movements for the specified time period.
curl -X GET "https://api.chartmogul.com/v2/metrics/mrr_movements" \
-u YOUR_API_KEY: \
-G \
-d start=2026-08-01 \
-d end=2026-10-31 \
-d interval=month
{
"entries": [
{
"date": "2026-10-31",
"new_biz_mrr": 96000.0,
"new_biz_activity_count": 8,
"new_biz_customer_count": 8,
"expansion_mrr": 0.0,
"expansion_activity_count": 0,
"expansion_customer_count": 0,
"contraction_mrr": 0.0,
"contraction_activity_count": 0,
"contraction_customer_count": 0,
"churn_mrr": 0.0,
"churn_activity_count": 0,
"churn_customer_count": 0,
"reactivation_mrr": 0.0,
"reactivation_activity_count": 0,
"reactivation_customer_count": 0,
"entered_mrr": 0.0,
"entered_activity_count": 0,
"entered_customer_count": 0,
"left_mrr": 0.0,
"left_activity_count": 0,
"left_customer_count": 0,
"net_movement_mrr": 96000.0,
"net_movement_arr": 1152000,
"original_new_biz_mrr": 96000.0,
"original_new_biz_activity_count": 8,
"original_new_biz_customer_count": 8,
"original_churn_mrr": 0.0,
"original_churn_activity_count": 0,
"original_churn_customer_count": 0,
"original_reactivation_mrr": 0.0,
"original_reactivation_activity_count": 0,
"original_reactivation_customer_count": 0,
"reclassified_new_biz_mrr": 0.0,
"reclassified_new_biz_activity_count": 0,
"reclassified_new_biz_customer_count": 0,
"reclassified_churn_mrr": 0.0,
"reclassified_churn_activity_count": 0,
"reclassified_churn_customer_count": 0,
"reclassified_reactivation_mrr": 0.0,
"reclassified_reactivation_activity_count": 0,
"reclassified_reactivation_customer_count": 0,
"neutral_mrr": 0.0,
"neutral_activity_count": 0,
"neutral_customer_count": 0,
"mrr": 109900.0
}
]
}
Query parameters
startdate required- The start date of the required period of data. An ISO-8601 formatted date, e.g.
2026-08-01. Must not be later thanend. enddate required- The end date of the required period of data. An ISO-8601 formatted date, e.g.
2026-10-31. intervalstring required- One of
day,week,month,quarter, oryear. filtersstring optional- A set of filters to limit the results, formatted as CFL. Copy URL-encoded CFL from the app (e.g.,
filters=currency~ANY~%27USD%27) or write the expression manually and enclose the key-value pair in double quotes (e.g.,"filters=currency~ANY~'USD'"). To limit the results to certain countries or plans, use a filter; there are no separategeoandplansparameters.
Response
In the response, the entries key contains an object for each interval, with the following data:
date- The date of the end of the interval.
new_biz_mrr,expansion_mrr,contraction_mrr,churn_mrr,reactivation_mrr- The MRR movements of each type during the interval, in cents. Contraction and churn are negative.
*_activity_count,*_customer_count- The number of movements of each type and the number of customers they belong to.
entered_mrr,left_mrr- The MRR, in cents, of customers that moved into or out of the filtered segment during the interval, with their activity and customer counts.
original_*,reclassified_*- New Business, Churn and Reactivation as first recorded, and the part of them that was later reclassified, for example when a customer churns and comes back within the same interval.
neutral_mrr- The MRR, in cents, of movements that don't change a customer's total MRR, with their activity and customer counts.
net_movement_mrr- The sum of all MRR movements during the interval, in cents.
net_movement_arr- The same sum annualized (multiplied by 12), in cents.
mrr- The MRR at the end of the interval, in cents.