# 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. |
| [`connect_revenue.revenue`](https://docs.stripe.com/data/analytics/supported-metrics.md#connect-revenue-revenue) | `connect_revenue` | Platform revenue earned from Stripe Connect activity. |
| [`connect_margin.margin`](https://docs.stripe.com/data/analytics/supported-metrics.md#connect-margin-margin) | `connect_margin` | Platform net margin (revenue minus costs) from Stripe Connect activity. |
| [`connect_volume.payment_volume`](https://docs.stripe.com/data/analytics/supported-metrics.md#connect-volume-payment-volume) | `connect_volume` | Gross Connect pay-in volume. |
| [`connect_take_rate.take_rate`](https://docs.stripe.com/data/analytics/supported-metrics.md#connect-take-rate-take-rate) | `connect_take_rate` | Platform take rate for payments, expressed in basis points. |

## `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) |
| 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) |
| 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) |
| 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) |
| 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. |
| 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) |
| 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`. |
| Dimensions | `meter`, `customer` |
| Constraints | Meters with the `LAST` or `MAX` aggregation formula aren’t currently supported. |

## `connect_revenue.revenue` 

Platform revenue earned from the payments activity of your connected accounts.

| Detail | Value |
| --- | --- |
| Live mode ID | `metric_61VCm94osfoFqZcoL5` |
| Sandbox ID | `metric_test_61VCm944Sh2Uxix9j5` |
| Namespace | `connect_revenue` |
| Unit | Minor units of `currency` (for example, cents for USD) |
| Dimensions | `connected_account`, `connected_account_country`, `payment_method`, `product_category`, `platform_currency` |

## `connect_margin.margin` 

Platform net margin from connected account payments activity, calculated as the platform revenue minus platform costs. Related cost-component metrics (`stripe_fees`, `network_costs`, `refunds`, `disputes`, `application_fees`, `application_fee_refunds`, `account_debits`) are also available under the `connect_margin` namespace.

| Detail | Value |
| --- | --- |
| Live mode ID | `metric_61VCm88p4L0twgRpy5` |
| Sandbox ID | `metric_test_61VCm88gVnWoMljqO5` |
| Namespace | `connect_margin` |
| Unit | Minor units of `currency` (for example, cents for USD) |
| Dimensions | `connected_account`, `connected_account_country`, `payment_method`, `product_category`, `platform_currency` |

## `connect_volume.payment_volume` 

Gross Connect pay-in volume. The related `connect_volume.payment_count` metric returns the number of successful pay-in transactions.

| Detail | Value |
| --- | --- |
| Live mode ID | `metric_61VCm9BZxyRIpzAKQ5` |
| Sandbox ID | `metric_test_61VCm9BcyMuVazunw5` |
| Namespace | `connect_volume` |
| Unit | Minor units of `currency` (for example, cents for USD) |
| Dimensions | `connected_account`, `connected_account_country`, `payment_method`, `platform_currency` |

## `connect_volume.transfer_volume` 

Gross Connect transfer volume. The related `connect_volume.transfer_count` metric returns the number of successful transfers.

| Detail | Value |
| --- | --- |
| Live mode ID | `metric_61VFepxD4pTRD0tlN5` |
| Sandbox ID | `metric_test_61VFepxefEqftUFjF5` |
| Namespace | `connect_volume` |
| Unit | Minor units of `currency` (for example, cents for USD) |
| Dimensions | `connected_account_country`, `platform_currency` |

## `connect_take_rate.take_rate` 

Platform take rate for payments, calculated as the margin from payments divided by gross Connect pay-in volume. Returns 0 when volume is zero or null. Related metrics (`payments_margin`, `payment_volume`, `stripe_fees`, `network_costs`, `refunds`, `disputes`, `application_fees`, `application_fee_refunds`, `account_debits`) are also available under the `connect_take_rate` namespace.

| Detail | Value |
| --- | --- |
| Live mode ID | `metric_61VCm9P1Qn3GQXgoI5` |
| Sandbox ID | `metric_test_61VCm9PyIMtNGHggy5` |
| Namespace | `connect_take_rate` |
| Unit | Basis points (1 percent = 100 basis points). The `currency` field on results is `null` because this is a ratio, not a monetary value. |
| Dimensions | `connected_account`, `connected_account_country`, `payment_method` |