Public preview

Adds the Reporting Query Runs API v2 Public preview

What’s new

Adds the Reporting Query Runs API v2, which allows you to programmatically run SQL queries against your Stripe data and retrieve the results.

This API introduces the Query Run v2 object (ID prefix qryrun_). You can create a query run to execute a SQL query against your Stripe data and retrieve the status and results of a query run.

Query results are delivered through pre-signed S3 URLs that expire after 5 minutes for security. The API also includes four events to track the query run lifecycle:

• v2. data. reporting. query _ run. created
• v2. data. reporting. query _ run. succeeded
• v2. data. reporting. query _ run. failed
• v2. data. reporting. query _ run. updated

Impact

You can programmatically access and analyze your Stripe data without manually exporting reports from the Dashboard. This allows you to:

• Build custom analytics dashboards that pull data directly from your Stripe data
• Automate reporting workflows by executing SQL queries on a schedule
• Integrate Stripe data analysis into your existing business intelligence tools
• Create real-time monitoring and alerting based on your payment and business metrics

To learn more, see Run a SQL query from the Reports API v2.

Changes

Upgrade

1. View your current API version in Workbench.
2. If you use an SDK, upgrade to the corresponding SDK version for this API version.

• If you don’t use an SDK, update your API requests to include Stripe-Version: 2026-04-22. preview

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .
6. In Workbench, perform the upgrade . You can roll back the version for 72 hours.

Learn more about Stripe API upgrades.