PApaddlehq
Metrics

Get MRR (monthly recurring revenue) metrics

Changed on

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.

get/metrics/monthly-recurring-revenue

Request

  • Base URL
    https://sandbox-api.paddle.com
  • Auth
    HTTP bearer

Query parameters

fromstring 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.

tostring 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

The request has succeeded.

Example response

{
  "data": {
    "timeseries": [
      {
        "timestamp": "2024-10-12T07:20:50.52Z",
        "amount": "391308"
      }
    ],
    "starts_at": "2024-10-12T07:20:50.52Z",
    "ends_at": "2024-10-12T07:20:50.52Z",
    "updated_at": "2024-10-13T07:20:50.52Z"
  },
  "meta": {
    "request_id": "b15ec92e-8688-40d4-a04d-f44cbec93355"
  }
}

Changes