# Supported metrics A complete list of metrics available through the Analytics API. This page lists every metric available through the [Analytics API](https://docs.stripe.com/data/analytics.md). The following details apply to every metric below unless noted otherwise: - **Granularity**: `day`, `week`, `month`, and `year` are all supported. - **Freshness**: Results are typically updated within 1 hour of the underlying activity. - **Currency conversion**: Monetary values are converted to the `currency` you specify (or to your account’s default currency). - **Time zone**: Results are aligned to the timezone you specify (or to your account’s default timezone). ## Summary | Common name | Namespace | What it measures | | ------------------------------------------------------------------------------------------------------------------------------------------------ | --------------------- | --------------------------------------------------------------------- | | [`revenue.mrr`](https://docs.stripe.com/data/analytics/supported-metrics.md#revenue-mrr) | `revenue` | Monthly recurring revenue from active and past-due subscriptions. | | [`revenue.arr`](https://docs.stripe.com/data/analytics/supported-metrics.md#revenue-arr) | `revenue` | Annual recurring revenue from active and past-due subscriptions. | | [`revenue_growth.mrr`](https://docs.stripe.com/data/analytics/supported-metrics.md#revenue-growth-mrr) | `revenue_growth` | Net change in MRR over time, broken down by `change_type`. | | [`revenue_growth.arr`](https://docs.stripe.com/data/analytics/supported-metrics.md#revenue-growth-arr) | `revenue_growth` | Net change in ARR over time, broken down by `change_type`. | | [`revenue_growth_rate.mrr`](https://docs.stripe.com/data/analytics/supported-metrics.md#revenue-growth-rate-mrr) | `revenue_growth_rate` | 30-day rolling MRR growth rate, expressed in basis points. | | [`usage_based_billing.gross_usage_revenue`](https://docs.stripe.com/data/analytics/supported-metrics.md#usage-based-billing-gross-usage-revenue) | `usage_based_billing` | Gross usage revenue across all meters, excluding taxes and discounts. | | [`metered_usage.total_aggregate_usage`](https://docs.stripe.com/data/analytics/supported-metrics.md#metered-usage-total-aggregate-usage) | `metered_usage` | Aggregate usage totals per meter and customer. | ## `revenue.mrr` Monthly recurring revenue (MRR) from all active and past-due subscriptions. | Detail | Value | | ------------------- | ---------------------------------------------------------------------------------------------- | | Live mode ID | `metric_61UYCfg0c4d6wCgE05` | | Sandbox ID | `metric_test_61UYCfgFqfg8KWGdo5` | | Namespace | `revenue` | | Unit | Minor units of `currency` (for example, cents for USD) | | Group-by dimensions | `price`, `product`, `customer`, `subscription`, `price_name`, `product_name`, `customer_email` | | Filter dimensions | `price`, `product`, `customer`, `subscription` | ## `revenue.arr` Annual recurring revenue (ARR) from all active and past-due subscriptions. | Detail | Value | | ------------------- | ---------------------------------------------------------------------------------------------- | | Live mode ID | `metric_61UYCgWhAExXw5Im65` | | Sandbox ID | `metric_test_61UYCgW3o5Vro8w1q5` | | Namespace | `revenue` | | Unit | Minor units of `currency` (for example, cents for USD) | | Group-by dimensions | `price`, `product`, `customer`, `subscription`, `price_name`, `product_name`, `customer_email` | | Filter dimensions | `price`, `product`, `customer`, `subscription` | ## `revenue_growth.mrr` Net change in MRR over time, broken down by change type: new, reactivation, expansion, contraction, churn, and FX adjustment. Filter on `change_type` to isolate specific components. | Detail | Value | | ------------------- | ------------------------------------------------------ | | Live mode ID | `metric_61UYCgg29rvcx97dr5` | | Sandbox ID | `metric_test_61UYCgg07FN065QHA5` | | Namespace | `revenue_growth` | | Unit | Minor units of `currency` (for example, cents for USD) | | Group-by dimensions | `change_type` | | Filter dimensions | `change_type` | ## `revenue_growth.arr` Net change in ARR over time, broken down by change type: new, reactivation, expansion, contraction, churn, and FX adjustment. Filter on `change_type` to isolate specific components. | Detail | Value | | ------------------- | ------------------------------------------------------ | | Live mode ID | `metric_61UYCgq54uoObgYFC5` | | Sandbox ID | `metric_test_61UYCgqZbqDuBRmEX5` | | Namespace | `revenue_growth` | | Unit | Minor units of `currency` (for example, cents for USD) | | Group-by dimensions | `change_type` | | Filter dimensions | `change_type` | ## `revenue_growth_rate.mrr` 30-day rolling MRR growth rate, computed as `((MRR_today / MRR_30_days_ago) - 1) × 10,000` (so 5% growth is returned as `500`). Returns 0 when prior-period MRR is zero. | Detail | Value | | ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | | Live mode ID | `metric_61UYCh0pUXR6JZulP5` | | Sandbox ID | `metric_test_61UYCh098vd7Wwwoe5` | | Namespace | `revenue_growth_rate` | | Unit | Basis points (1 percent = 100 basis points). The `currency` field on results is `null` because this is a percentage, not a monetary value. | | Group-by dimensions | `price`, `product`, `customer`, `price_name`, `product_name`, `customer_email` | | Filter dimensions | `price`, `product`, `customer` | ## `usage_based_billing.gross_usage_revenue` Gross monetary revenue generated from usage events across all meters during a given time period, excluding taxes and discounts. | Detail | Value | | ------------------- | ------------------------------------------------------------------------------------------------------------ | | Live mode ID | `metric_61UYChCzdsDwmJDRi5` | | Sandbox ID | `metric_test_61UYChCcFUOh6ieln5` | | Namespace | `usage_based_billing` | | Unit | Minor units of `currency` (for example, cents for USD) | | Group-by dimensions | `price`, `product`, `customer`, `meter`, `price_name`, `product_name` | | Filter dimensions | `price`, `product`, `customer`, `meter` | | Constraints | Meters with the `LAST` or `MAX` aggregation formula aren’t supported. Data is available starting 2025-04-02. | ## `metered_usage.total_aggregate_usage` Aggregate usage totals per meter and customer, computed using each meter’s aggregation formula (for example, `SUM` or `COUNT`). | Detail | Value | | ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | Live mode ID | `metric_61UYChMzN9s7jD5Nj5` | | Sandbox ID | `metric_test_61UYChMHjW6SV6wcS5` | | Namespace | `metered_usage` | | Unit | Determined by the meter’s aggregation formula (counts or summed amounts in the meter’s units). The `currency` field on results is `null`. | | Group-by dimensions | `meter`, `customer` | | Filter dimensions | `meter`, `customer` | | Constraints | Meters with the `LAST` or `MAX` aggregation formula aren’t currently supported. |