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

start date required
The start date of the required period of data. An ISO-8601 formatted date, e.g. 2026-08-01. Must not be later than end.
end date required
The end date of the required period of data. An ISO-8601 formatted date, e.g. 2026-10-31.
interval string required
One of day, week, month, quarter, or year.
filters string 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 separate geo and plans parameters.

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_movement from the previous entry.
total_mrr
The MRR at the end of the interval, in cents.