# Ajout de l’API Reporting Query Runs v2

## Nouveautés

Ajoute l’[API Reporting Query Runs v2](https://docs.stripe.com/api/v2/data/reporting/query-runs.md?api-version=2026-04-22.preview), qui vous permet d’exécuter par voie programmatique des requêtes SQL sur vos données Stripe et d’en récupérer les résultats.

Cette API introduit l’objet [Query Run v2](https://docs.stripe.com/api/v2/data/reporting/query-runs/object.md?api-version=2026-04-22.preview) (préfixe ID `qryrun_`). Vous pouvez [créer](https://docs.stripe.com/api/v2/data/reporting/query-runs/create.md?api-version=2026-04-22.preview) une exécution de requête pour exécuter une requête SQL sur vos données Stripe et [récupérer](https://docs.stripe.com/api/v2/data/reporting/query-runs/retrieve.md?api-version=2026-04-22.preview) l’état et les résultats d’une exécution de requête.

Les résultats des requêtes sont fournis via des URL S3 présignées qui expirent au bout de 5 minutes pour des raisons de sécurité. L’API comprend également [quatre événements](https://docs.stripe.com/api/v2/data/reporting/query-runs/event-types.md?api-version=2026-04-22.preview) pour suivre le cycle de vie de l’exécution des requêtes :

- `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

Vous pouvez accéder à vos données Stripe et les analyser par voie programmatique sans exporter manuellement les rapports depuis le Dashboard. Cela vous permet de :

- Créer des dashboards d’analyse personnalisés qui extraient les données directement de vos données Stripe
- Automatiser les flux de reporting en exécutant des requêtes SQL selon un certain calendrier
- Intégrer l’analyse des données Stripe à vos outils de veille stratégique existants
- Créer un suivi et des alertes en temps réel basés sur les indicateurs de votre paiement et de votre entreprise

Pour en savoir plus, consultez [Exécuter une requête SQL depuis l’API Reports v2](https://docs.stripe.com/reports/query-runs.md).

## Modifications

#### API REST

|  | Change | Resource                                                                                                                  |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Data.Reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

| Endpoints            | Change | Resource                                                                                                                  |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Data.Reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

|                                                                                                                                                             | Change | Event type                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `V2DataReportingQueryRunCreatedEvent`, `V2DataReportingQueryRunFailedEvent`, `V2DataReportingQueryRunSucceededEvent`, `V2DataReportingQueryRunUpdatedEvent` | Added  | `V2.Data.Reporting.QueryRun` |

#### Ruby

|  | Change | Resource                                                                                                                     |
|  | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2::Data::Reporting::QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

| Methods              | Change | Resource                                                                                                                     |
| -------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2::Data::Reporting::QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

|                                                                                                                                                             | Change | Event type                      |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------------- |
| `V2DataReportingQueryRunCreatedEvent`, `V2DataReportingQueryRunFailedEvent`, `V2DataReportingQueryRunSucceededEvent`, `V2DataReportingQueryRunUpdatedEvent` | Added  | `V2::Data::Reporting::QueryRun` |

#### Python

|  | Change | Resource                                                                                                                  |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [v2.data.reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

| Methods              | Change | Resource                                                                                                                  |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [v2.data.reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

|                                                                                                                                                             | Change | Event type                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `V2DataReportingQueryRunCreatedEvent`, `V2DataReportingQueryRunFailedEvent`, `V2DataReportingQueryRunSucceededEvent`, `V2DataReportingQueryRunUpdatedEvent` | Added  | `v2.data.reporting.QueryRun` |

#### PHP

|  | Change | Resource                                                                                                                  |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Data.Reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

| Methods              | Change | Resource                                                                                                                  |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Data.Reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

|                                                                                                                                                             | Change | Event type                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `V2DataReportingQueryRunCreatedEvent`, `V2DataReportingQueryRunFailedEvent`, `V2DataReportingQueryRunSucceededEvent`, `V2DataReportingQueryRunUpdatedEvent` | Added  | `V2.Data.Reporting.QueryRun` |

#### Java

|  | Change | Resource                                                                                                                  |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [v2.data.reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

| Methods              | Change | Resource                                                                                                                  |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [v2.data.reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

|                                                                                                                                                             | Change | Event type                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `V2DataReportingQueryRunCreatedEvent`, `V2DataReportingQueryRunFailedEvent`, `V2DataReportingQueryRunSucceededEvent`, `V2DataReportingQueryRunUpdatedEvent` | Added  | `v2.data.reporting.QueryRun` |

#### Node.js

|  | Change | Resource                                                                                                                  |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Data.Reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

| Methods              | Change | Resource                                                                                                                  |
| -------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| `create`, `retrieve` | Added  | [V2.Data.Reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

|                                                                                                                                                             | Change | Event type                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `V2DataReportingQueryRunCreatedEvent`, `V2DataReportingQueryRunFailedEvent`, `V2DataReportingQueryRunSucceededEvent`, `V2DataReportingQueryRunUpdatedEvent` | Added  | `V2.Data.Reporting.QueryRun` |

#### Go

|  | Change | Resource                                                                                                               |
|  | ------ | ---------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2DataReportingQueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

| Methods      | Change | Resource                                                                                                               |
| ------------ | ------ | ---------------------------------------------------------------------------------------------------------------------- |
| `Get`, `New` | Added  | [V2DataReportingQueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

|                                                                                                                                                             | Change | Event type                |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ------------------------- |
| `V2DataReportingQueryRunCreatedEvent`, `V2DataReportingQueryRunFailedEvent`, `V2DataReportingQueryRunSucceededEvent`, `V2DataReportingQueryRunUpdatedEvent` | Added  | `V2DataReportingQueryRun` |

#### .NET

|  | Change | Resource                                                                                                                  |
|  | ------ | ------------------------------------------------------------------------------------------------------------------------- |
|  | Added  | [V2.Data.Reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

| Methods         | Change | Resource                                                                                                                  |
| --------------- | ------ | ------------------------------------------------------------------------------------------------------------------------- |
| `Create`, `Get` | Added  | [V2.Data.Reporting.QueryRun](/api/v2/data/reporting/query-runs/object?api-version=2026-04-22.preview#v2_query_run_object) |

|                                                                                                                                                             | Change | Event type                   |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------- | ------ | ---------------------------- |
| `V2DataReportingQueryRunCreatedEvent`, `V2DataReportingQueryRunFailedEvent`, `V2DataReportingQueryRunSucceededEvent`, `V2DataReportingQueryRunUpdatedEvent` | Added  | `V2.Data.Reporting.QueryRun` |

## Mise à niveau

#### API REST

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Si vous utilisez un SDK, passez à une version correspondant à celle de l’API.
   - Si vous n’utilisez pas de SDK, mettez à jour vos [requêtes API](https://docs.stripe.com/api/versioning.md) pour inclure la `version Stripe : 2026-04-22.preview`
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Ruby

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Ruby vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Python

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Python vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### PHP

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK PHP vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Java

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Java vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Node.js

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Node vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### Go

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK Go vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).

#### .NET

1. [Consultez la version actuelle de votre API](https://docs.stripe.com/upgrades.md#view-your-api-version-and-the-latest-available-upgrade-in-workbench) dans Workbench.
1. Mettez à niveau votre SDK .NET vers la dernière version.
1. Mettez à niveau la version de l’API utilisée pour les [endpoints de webhook](https://docs.stripe.com/webhooks/versioning.md).
1. [Testez votre intégration](https://docs.stripe.com/testing.md) avec la nouvelle version.
1. Si vous utilisez Connect, [testez votre intégration Connect](https://docs.stripe.com/connect/testing.md).
1. [Effectuez la mise à niveau](https://docs.stripe.com/upgrades.md#perform-the-upgrade) dans Workbench. Vous pourrez [revenir à la version précédente](https://docs.stripe.com/upgrades.md#roll-back-your-api-version) pendant 72 heures.

En savoir plus sur les [mises à niveau de l’API Stripe](https://docs.stripe.com/upgrades.md).