Net MRR Movements
GET https://api.chartmogul.com/v2/metrics/net_mrr_movements
Retrieves the Net MRR movements for the specified time period.
curl -X GET "https://api.chartmogul.com/v2/metrics/net_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",
"net_new_biz_mrr": 96000.0,
"net_new_biz_customer_count": 8,
"net_expansion_mrr": 0.0,
"net_expansion_customer_count": 0,
"net_contraction_mrr": 0.0,
"net_contraction_customer_count": 0,
"net_churn_mrr": 0.0,
"net_churn_customer_count": 0,
"net_reactivation_mrr": 0.0,
"net_reactivation_customer_count": 0,
"net_new_to_churn_mrr": 0.0,
"net_new_to_churn_customer_count": 0,
"entered_mrr": 0.0,
"entered_customer_count": 0,
"left_mrr": 0.0,
"left_customer_count": 0,
"currency_fluctuations_mrr": 0.0,
"currency_fluctuations_activity_count": 0,
"currency_fluctuations_customer_count": 0,
"net_mrr_movement": 96000.0,
"net_arr_movement": 1152000,
"percentage_change": null,
"total_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.
net_new_biz_mrr,net_expansion_mrr,net_contraction_mrr,net_churn_mrr,net_reactivation_mrr- The net MRR change during the interval of customers in each group, in cents. Each customer falls into one group per interval, based on their MRR at its start and end.
net_new_to_churn_mrr- The net MRR change of customers that subscribed and churned within the same interval, in cents.
*_customer_count- The number of customers in each group.
entered_mrr,left_mrr- The MRR, in cents, of customers that moved into or out of the filtered segment during the interval, with their customer counts.
currency_fluctuations_mrr- The MRR change caused by exchange rate fluctuations, in cents, with its activity and customer counts.
net_mrr_movement- The total net MRR change during the interval, in cents.
net_arr_movement- The same change annualized (multiplied by 12), in cents.
percentage_change- The percentage change of
net_mrr_movementfrom the previous entry. total_mrr- The MRR at the end of the interval, in cents.