Metrics

MRR, ARR, ARPA, customer counts and the churn rates, as a series over any interval.

GET/api/v1/metrics/{metric}

One entry per period, plus a summary comparing the last period to the one before it. Periods are included when they end inside your range, which is the same rule the dashboard applies to its columns.

Path parameter

metricrequired

string

One of all, mrr, arr, arpa, ltv, customer-count, mrr-growth-rate, customer-churn-rate, gross-mrr-churn-rate, net-mrr-churn-rate.

Query parameters

start-daterequired YYYY-MM-DD	First day of the range.
end-daterequired YYYY-MM-DD	Last day of the range, included in full.
interval string	day, week, month, quarter or year. Defaults to month.

curl -G https://kometrics.com/api/v1/metrics/mrr \
  -H "Authorization: Bearer ko_your_api_key" \
  -d start-date=2026-01-01 \
  -d end-date=2026-06-30 \
  -d interval=month

Three response shapes

Which fields an entry carries depends on the metric you asked for.

Metric	Entry shape
all	Every field the engine computes for the period, listed below.
mrr	`date` and `mrr`, plus the five movement components.
Everything else	`date` and `value`.

Fields on an `all` entry

date YYYY-MM-DD	Last day of the period. The in-progress period reads as today.
mrr integer	Monthly recurring revenue at period end, in cents.
arr integer	Annual run rate, mrr times twelve.
customers integer	Customers with paid MRR at period end.
arpa integer \| null	Average revenue per account. Null with no customers.
ltv integer \| null	Customer lifetime value: ARPA over the mean customer churn rate of the six preceding periods. Null until there is enough history.
mrr-new-business integer	MRR from customers who started paying in the period.
mrr-expansion integer	MRR gained from existing customers.
mrr-contraction integer	MRR lost to downgrades. Negative.
mrr-churn integer	MRR lost to cancellations. Negative.
mrr-reactivation integer	MRR from customers who came back.
mrr-net-movement integer	The five movements above, summed.
mrr-growth-rate number \| null	Percent change in MRR against the previous period.
customer-churn-rate number \| null	Percent of customers lost, against the period start count.
gross-mrr-churn-rate number \| null	Churn plus contraction over MRR at period start.
net-mrr-churn-rate number \| null	The same, net of expansion and reactivation.
subscriber-growth-rate number \| null	Percent change in customer count.

Rates are null for a period with no starting base to divide by, which is normally the first period of a book.

curl -G https://kometrics.com/api/v1/metrics/customer-churn-rate \
  -H "Authorization: Bearer ko_your_api_key" \
  -d start-date=2026-01-01 \
  -d end-date=2026-06-30