KometricsDocsBack to site

Revenue

Revenue for a month or any date range: cash already received plus what is still expected to bill.

GET/v1/revenue

How much money a month, or any stretch of dates, brings in. received is the cash that already landed in it. expected is what your active subscriptions are still due to bill inside it, each one projected from the cycle it bills on. A range in the past is all received, a range ahead is all expected, and one that crosses today has both without counting anything twice.

This is not MRR. An annual customer counts in full on its renewal day, so a month with several annual renewals totals more than MRR and a month with none totals less. Over a full year the two meet. Use it to plan cash, or to hand another agent a number it can do arithmetic on.

Query parameters

month
string
A calendar month, YYYY-MM. Cannot be combined with start and end.
start
string
Range start, YYYY-MM-DD, inclusive, in your account timezone. Requires end.
end
string
Range end, YYYY-MM-DD, inclusive. At most 1,096 days after start and 36 months ahead of today.

Send nothing and you get the current month. Anything outside those limits, or month together with start and end, is a 422 that says which rule it broke.

Response fields

start
string
First day answered, YYYY-MM-DD.
end
string
Last day answered, YYYY-MM-DD.
as-of
string
Today in your account timezone. Received runs through it, expected starts from it.
currency
string
Your account currency. Every amount is in its cents.
received
integer
Cash landed in the range so far, in cents, one-off charges included.
expected
integer
Renewals still due inside the range, in cents.
expected-monthly
integer
The part of expected billed on a monthly cycle.
expected-annual
integer
The part of expected billed on an annual cycle.
expected-payments
integer
How many renewals make up expected.
total
integer
received plus expected.
months[]
array
One row per calendar month the range touches, oldest first, with the same money fields. The rows add up to the totals.
months[].month
string
The month, YYYY-MM.
months[].start
string
The part of the range inside this month: its first day.
months[].end
string
And its last day.
Amounts are gross: before processor fees and refunds. Expected assumes nobody new signs up and nobody else cancels; subscriptions already scheduled to cancel stop at their cancellation date, and past due ones are still counted. One-off charges cannot be projected, so they only ever show up in received.
curl "https://api.kometrics.com/v1/revenue?month=2027-05" \
  -H "Authorization: Bearer ko_your_api_key"

curl "https://api.kometrics.com/v1/revenue?start=2026-12-01&end=2027-11-30" \
  -H "Authorization: Bearer ko_your_api_key"