Adds support for filtering by event type to Events v2
What’s new
Events v2 now supports filtering events by type using the types parameter. The object_id parameter is now optional.
Impact
You can now filter events by specific event types using the types parameter and by time ranges using created.gt, created.gte, created.lt, and created.lte parameters. The object_id parameter is now optional, allowing you to list events without specifying a particular object.
Changes
| Parameters | Change | Resources or endpoints |
|---|---|---|
| created types | Added | V2.Event#list |
| Field | Change | From → to |
| V2. Event#list. object_id | Changed | required → optional |
Upgrade
- View your current API version in Workbench.
- 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: 2025-10-29. clover
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
- In Workbench, perform the upgrade . You can roll back the version for 72 hours.
Learn more about Stripe API upgrades.