Each major release, such as Acacia, includes changes that aren’t backward-compatible with previous releases. Upgrading to a new major release can require updates to existing code. Each monthly release includes only backward-compatible changes, and uses the same name as the last major release. You can safely upgrade to a new monthly release without breaking any existing code. The current version is 2025-08-27.basil. For information on all API versions, view our API changelog.
By default, requests made with curl use your Stripe account’s default API version (controlled in Workbench) unless you override it by setting the Stripe-Version header.
Webhook events also use your account’s API version by default, unless you set an API version during endpoint creation.
You can upgrade your API version in Workbench. As a precaution, use API versioning to test a new API version before committing to an upgrade.