ARR
GET https://api.chartmogul.com/v2/metrics/arr
Retrieves the Annualized Run Rate (ARR) for the specified time period.
curl -X GET "https://api.chartmogul.com/v2/metrics/arr" \
-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": 166800.0,
"value_in_usd": 166800,
"percentage-change": 0
},
{
"date": "2026-10-31",
"value": 1318800.0,
"value_in_usd": 1318800,
"percentage-change": 690.65
}
],
"summary": {
"current": 1474800.0,
"previous": 166800.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 ARR at the end of the interval, in cents.
value_in_usd- The same ARR converted to US dollars, in cents.
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 ARR 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.