Revenue
Revenue for a month or any date range: cash already received plus what is still expected to bill.
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. |
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"