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