---
title: "Current MRR by billing interval"
method: GET
path: "/companies/{companyId}/metrics/mrr-by-interval"
tags: ["Overview"]
---

# Current MRR by billing interval

`GET /companies/{companyId}/metrics/mrr-by-interval`

## Request

- Base URL: `https://api.medianfi.com/api/v1`
- URL: `https://api.medianfi.com/api/v1/companies/{companyId}/metrics/mrr-by-interval`
- Auth: HTTP bearer

Current recurring MRR split by Stripe billing interval (#2566), from the synced subscriptions in customer_subscriptions. MRR, not revenue: each subscription contributes its normalized-monthly MRR (an annual plan is its yearly amount / 12, exact minor units), counting the same paying statuses (active, past_due) as the Home MRR tile. Rows are `monthly` (1-month interval), `annual` (1-year interval) and `other` (any other cadence), omitted when empty. The split is published only when its total equals the tile's live current MRR; otherwise `available` is false with reason `unreconciled`. `no_subscriptions` means nothing is paying; other reasons are the MRR readiness reasons.

## Query parameters

- `entityId` string, uuid, required

## Response `200`

MRR by billing interval payload

- MrrByIntervalResponse
  - `success` true, required
  - `data` object, required
    - `available` boolean, required
    - `reason` string, nullable, required: Null when available; otherwise an MRR readiness reason, `no_subscriptions`, or `unreconciled`.
    - `asOf` string, date, nullable, required: Month start of the current-month MRR snapshot the split reconciles to.
    - `currency` string, nullable, required
    - `minorUnitExponent` integer, nullable, required
    - `totalMinorUnits` string, nullable, required: Equals the Home MRR tile's live current MRR.
    - `subscriptionCount` integer, required
    - `rows` object[], required
      - `key` 'monthly' | 'annual' | 'other', required
      - `mrrMinorUnits` string, required
      - `subscriptionCount` integer, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions or not a company member
- `422`: Request failed validation
- `503`: The legal-entity scope authority could not be read

---

[API](https://skmtc.dev/medianfi/apis/median-api.md) · [All operations](https://skmtc.dev/medianfi/apis/median-api/llms.txt) · [OpenAPI document](https://skmtc.dev/medianfi/apis/median-api/revisions/20090ea32b0d?raw)