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

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.
include_summary boolean optional default: false
Set to true to add the summary key to the response.
include_data_table boolean optional default: false
Set to true to add the data_table key 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. null when the request has filters or 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.