CMRR

GET https://api.chartmogul.com/v2/metrics/cmrr

Retrieves the Committed Monthly Recurring Revenue (CMRR) movements for the specified time period.

curl -X GET "https://api.chartmogul.com/v2/metrics/cmrr" \
     -u YOUR_API_KEY: \
     -G \
     -d start=2026-08-01 \
     -d end=2027-03-31 \
     -d interval=month
{
  "entries": [
    {
      "date": "2027-02-28",
      "new_biz_cmrr": 0.0,
      "new_biz_activity_count": 0,
      "new_biz_customer_count": 0,
      "expansion_cmrr": 0.0,
      "expansion_activity_count": 0,
      "expansion_customer_count": 0,
      "contraction_cmrr": 0.0,
      "contraction_activity_count": 0,
      "contraction_customer_count": 0,
      "churn_cmrr": 0.0,
      "churn_activity_count": 0,
      "churn_customer_count": 0,
      "reactivation_cmrr": 0.0,
      "reactivation_activity_count": 0,
      "reactivation_customer_count": 0,
      "net_movement_cmrr": 0.0,
      "net_movement_carr": 0
    },
    {
      "date": "2027-03-31",
      "new_biz_cmrr": 0.0,
      "new_biz_activity_count": 0,
      "new_biz_customer_count": 0,
      "expansion_cmrr": 0.0,
      "expansion_activity_count": 0,
      "expansion_customer_count": 0,
      "contraction_cmrr": 0.0,
      "contraction_activity_count": 0,
      "contraction_customer_count": 0,
      "churn_cmrr": 0.0,
      "churn_activity_count": 0,
      "churn_customer_count": 0,
      "reactivation_cmrr": 0.0,
      "reactivation_activity_count": 0,
      "reactivation_customer_count": 0,
      "net_movement_cmrr": 0.0,
      "net_movement_carr": 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 month or unlimited.
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_cmrr, expansion_cmrr, contraction_cmrr, churn_cmrr, reactivation_cmrr
The CMRR 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.
net_movement_cmrr
The sum of all CMRR movements during the interval, in cents.
net_movement_carr
The same sum annualized (multiplied by 12), in cents.

The period can end in the future: CMRR includes movements that are already scheduled.