MRR
GET https://api.chartmogul.com/v2/metrics/mrr
Retrieves the Monthly Recurring Revenue (MRR) for the specified time period.
curl -X GET "https://api.chartmogul.com/v2/metrics/mrr" \
-u YOUR_API_KEY: \
-G \
-d start=2026-08-01 \
-d end=2026-10-31 \
-d interval=month \
-d include_summary=true
{
"entries": [
{
"date": "2026-09-30",
"value": 13900.0,
"reported_value": null,
"taken_at": null,
"percentage-change": 0
},
{
"date": "2026-10-31",
"value": 109900.0,
"reported_value": null,
"taken_at": null,
"percentage-change": 690.65
}
],
"summary": {
"current": 122900.0,
"previous": 13900.0,
"percentage-change": 784.17
}
}
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. include_summaryboolean optional default: false- Set to
trueto add thesummarykey to the response. include_data_tableboolean optional default: false- Set to
trueto add thedata_tablekey to the response.
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.
value- The MRR at the end of the interval, in cents.
reported_value,taken_at- The MRR that ChartMogul reported for the interval right after it ended, in cents, and when that value was recorded.
nullwhen the request hasfiltersor no such record exists. percentage-change- The percentage change from the previous entry. Not present in the first entry.
The summary key is present when include_summary is true. It contains the current value and the value 30 days ago (current and previous) of MRR and the percentage change between the two (percentage-change).
The data_table key is present when include_data_table is true. It contains an object for each interval with the same data as the entries of MRR Movements.