---
title: "Get MRR (monthly recurring revenue) metrics"
method: GET
path: "/metrics/monthly-recurring-revenue"
tags: ["Metrics"]
---

# Get MRR (monthly recurring revenue) metrics

`GET /metrics/monthly-recurring-revenue`

## Request

- Base URL: `https://sandbox-api.paddle.com`
- URL: `https://sandbox-api.paddle.com/metrics/monthly-recurring-revenue`
- Auth: HTTP bearer

Returns timeseries data for monthly recurring revenue in a given date range. Trends have a daily granularity.
Current monthly recurring revenue total. Includes new subscriptions, upgrades, downgrades and churn. Does not include one-time payments or deductions for Paddle fees.

When `to` and `from` are the same, returns an empty timeseries.

## Query parameters

- `from` string, date, required
- `to` string, date, required

## Response `200`

The request has succeeded.

- object
  - `data` MetricsTimeseriesMonthlyRecurringRevenue, required: Monthly recurring revenue metrics timeseries with amount for each datapoint.
    - `currency_code` 'USD' | 'EUR' | 'GBP' | 'JPY' | 'AUD' | 'CAD' | 'CHF' | 'HKD' | 'SGD' | 'SEK' | 'ARS' | 'BRL' | 'CLP' | 'CNY' | 'COP' | 'CZK' | 'DKK' | 'HUF' | 'ILS' | 'INR' | 'KRW' | 'MXN' | 'NOK' | 'NZD' | 'PEN' | 'PLN' | 'RUB' | 'THB' | 'TRY' | 'TWD' | 'UAH' | 'VND' | 'ZAR', required: Supported three-letter ISO 4217 currency code.
    - `timeseries` MetricsTimeseriesMonthlyRecurringRevenueDatapoint[], required: Array of datapoints. Empty if `to` and `from` are the same.
      - `timestamp` string, date-time, required: RFC 3339 datetime string.
      - `amount` string, required: Amount for this datapoint in the lowest denomination for a currency.
    - `starts_at` string, date-time, required: RFC 3339 datetime string.
    - `ends_at` string, date-time, required: RFC 3339 datetime string.
    - `interval` 'day', required: Time granularity for the datapoints.
    - `updated_at` string, date-time, required: RFC 3339 datetime string of when this entity was updated. Set automatically by Paddle.
  - `meta` Meta, required: Information about this response.
    - `request_id` string, required: Unique ID for the request relating to this response. Provide this when contacting Paddle support about a specific request.

## Other responses

- `default`: An unexpected error response.

## Changes

- **2026-07-09** (v1) `e1ac347eb3c5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paddlehq/apis/paddle-api/changes/metrics/monthly-recurring-revenue/get.md)

---

[API](https://skmtc.dev/paddlehq/apis/paddle-api.md) - [All operations](https://skmtc.dev/paddlehq/apis/paddle-api/llms.txt) - [OpenAPI document](https://skmtc.dev/paddlehq/apis/paddle-api/revisions/bbc0c72039c8?raw)