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

**Get MRR change (monthly recurring revenue change) metrics**

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.

**Required permissions:** `metrics.read`

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `from` | string (date) | required | Return data from a specific date. Pass an RFC 3339 full-date string. Interpreted at 00:00 UTC. Must be before or the same as `to`. |
| `to` | string (date) | required | Return data up to a specific date. Pass an RFC 3339 full-date string. Interpreted as 00:00 UTC. Must be after or the same as `from`. |

## Response (200)

- `data`: object (required) — Monthly recurring revenue change metrics timeseries with amount for each datapoint.
  - `currency_code`: string (required) — Supported three-letter ISO 4217 currency code for this metric. Returned in your primary balance currency, converted using the exchange rate at the time of each transaction. If your primary balance currency changes, amounts continue to be returned in the previous currency until the next payout period begins.
  - `timeseries`: array (required) — Array of datapoints. Empty if `to` and `from` are the same.
  - `starts_at`: string (date-time) (required) — RFC 3339 datetime string for when this timeseries starts (inclusive).
  - `ends_at`: string (date-time) (required) — RFC 3339 datetime string for when this timeseries ends (exclusive).
  - `interval`: string (required) — Granularity for this timeseries.
  - `updated_at`: string (date-time) (required) — RFC 3339 datetime string of the last successful data refresh for this metric.
- `meta`: object (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.

### Response example

```json
{
  "data": {
    "timeseries": [
      {
        "timestamp": "2025-09-01T00:00:00Z",
        "amount": "125000"
      },
      {
        "timestamp": "2025-09-02T00:00:00Z",
        "amount": "-75000"
      },
      {
        "timestamp": "2025-09-03T00:00:00Z",
        "amount": "200000"
      },
      {
        "timestamp": "2025-09-04T00:00:00Z",
        "amount": "50000"
      }
    ],
    "starts_at": "2025-09-01T00:00:00Z",
    "ends_at": "2025-09-05T00:00:00Z",
    "interval": "day",
    "currency_code": "USD",
    "updated_at": "2025-09-04T20:30:00Z"
  },
  "meta": {
    "request_id": "b93d9c94-c28f-4e5d-af2e-044854d7afe8"
  }
}
```