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

# Get MRR change (monthly recurring revenue change) metrics

`GET /metrics/monthly-recurring-revenue-change`

## Request

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

Returns timeseries data for monthly recurring revenue change in a given date range. Trends have a daily granularity.
Monthly recurring revenue (MRR) change compared to the same time interval last month.

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` MetricsTimeseriesMonthlyRecurringRevenueChange, required: Monthly recurring revenue change 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-change/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)