Private preview
Supported metrics Private preview
A complete list of metrics available through the Analytics API.
This page lists every metric available through the Analytics API.
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 | revenue | Monthly recurring revenue from active and past-due subscriptions. |
| revenue.arr | revenue | Annual recurring revenue from active and past-due subscriptions. |
| revenue_growth.mrr | revenue_growth | Net change in MRR over time, broken down by change_type. |
| revenue_growth.arr | revenue_growth | Net change in ARR over time, broken down by change_type. |
| revenue_growth_rate.mrr | revenue_growth_rate | 30-day rolling MRR growth rate, expressed in basis points. |
| usage_based_billing.gross_usage_revenue | usage_based_billing | Gross usage revenue across all meters, excluding taxes and discounts. |
| metered_usage.total_aggregate_usage | metered_usage | Aggregate usage totals per meter and customer. |
| connect_connections.new_connections | connect_connections | New connected account connections. Related metrics track disconnections and net change. |
connect_revenue.revenue | connect_revenue | Platform revenue earned from Stripe Connect activity. |
| connect_margin.margin | connect_margin | Platform net margin (revenue minus costs) from Stripe Connect activity. |
| connect_volume.payment_volume | connect_volume | Gross Connect pay-in volume. |
| connect_take_rate.take_rate | connect_take_rate | Platform take rate for payments, expressed in basis points. |
| connect_support_cases.count | connect_support_cases | Support cases created by connected accounts, excluding cases created by platforms on their behalf. Requires separate preview access. |
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 the related setting 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 the related setting).
| 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 the related setting or MAX aggregation formula aren’t currently supported. |
connect_connections.new_connections
Number of new connections established between your platform and connected accounts. Related metrics include connect_connections.disconnections for disconnected accounts and connect_connections.net_change for new connections minus disconnections.
| Detail | Value |
|---|---|
| Live mode ID | metric_61VO0vxnFoYf7Mg5g5 |
| Sandbox ID | metric_test_61VO0vxK3lPF4SeXR5 |
| Namespace | connect_connections |
| Unit | Number of connected account connections. The currency field on results is null. |
| Dimensions | connected_account_country, account_configuration, capability_status |
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 |
Connect support cases count
connect_support_cases.count returns the number of support cases created by connected accounts, grouped by case creation time. It excludes cases created by platforms on behalf of connected accounts. Response time, resolution time, and customer satisfaction (the related setting) dimensions describe count distributions, not averages.
This metric requires separate private preview enablement for your platform, in addition to Analytics API access. Your caller needs both analytics read access ( analytics_read) and support case read access ( support_case_read) on your platform. Results stay scoped to your platform and request mode; filtering by a connected account that’s connected to another platform doesn’t grant access to the other platform’s cases.
| Detail | Value |
|---|---|
| Common name | connect_support_cases.count |
| Live mode ID | metric_61VR1epCUG31ECvvA5 |
| Sandbox ID | metric_test_61VR1epA6ZjCB7PPL5 |
| Namespace | connect_support_cases |
| Unit | Integer number of cases. |
| Time | Case creation time, with day, week, month, or year granularity. Set the timezone parameter in the request body to select a time zone. If you omit this parameter, the API uses your platform’s default time zone. |
| Freshness | Refreshed daily. refreshed_at reports the source data watermark for successful queries; it isn’t the response creation time. |
Dimensions
You can filter and group by every dimension in this table. Each filter accepts up to 10 values. product and topic are support classifications; product doesn’t refer to a Stripe Product ID.
| Dimension | Values or meaning |
|---|---|
connected_account | Connected account ID. |
status | new, open, solved, closed, or invalid. invalid represents an unexpected source status after normalization. |
product | Support product classification string. |
topic | Support topic classification string. |
channel | chat, request_a_call, email, or critical_issue. |
resolution_time_bucket | lt_1d: less than 24 hours. lt_3d: at least 24 and less than 72 hours. lt_7d: at least 72 and less than 168 hours. gte_7d: at least 168 hours. |
first_response_time_bucket | lt_12h: less than 12 hours. gte_12h: at least 12 hours. |
csat_rating_bucket | gte_4: rating of 4 or higher. eq_3: rating of 3. lte_2: rating of 2 or lower. |
The total count includes cases without a response-time measurement, resolution-time measurement, or the related setting rating, but their corresponding source buckets are null. To query a distribution that excludes unmeasured cases, filter that dimension to its complete list of valid bucket values, as in the following example.
Query behavior
Consider the following when querying connected account support cases:
- Queries always return time series; all and quarter aren’t supported granularities.
- Grouping can select the highest-count dimension values and combine remaining values into an Other bucket.
- The limit parameter caps the total number of returned rows across all time buckets and groups. For example, limit: 5 doesn’t request the exact top-five account table shown in the Dashboard.
- Ungrouped queries without data return zero-valued time buckets.
- Grouped queries without groups return an empty result.
- Without grouping, you can filter on at most two dimensions. With grouping, you can filter the grouping dimensions and at most one additional dimension.
- All metrics in a request must share the connect _ support _ cases namespace.
- Omit the currency parameter from your request. This count metric doesn’t accept it and returns no currency value.
Query a resolution-time distribution
The following example request returns daily counts for measured resolution-time buckets. Omit the filter to include cases without a resolution-time measurement in the population.
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
The common name works in either mode. If your integration stores the metric ID returned in a response, you can use that ID in subsequent requests in the same mode. To query by ID, replace the metric selector with { id: "metric_test_61VR1epA6ZjCB7PPL5" } in a sandbox or { id: "metric_61VR1epCUG31ECvvA5" } in live mode. Whether you use the common name or a mode-specific ID, each result identifies the metric with its mode-specific ID.