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

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.
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.