Breaking changes
Removes iterations parameter for subscription schedules Breaking changes
What’s new
We’ve removed the iterations parameter because duration replaces its functionality.
Why is this a breaking change?
We no longer support the iterations parameter for Subscription Schedules.
Impact
You must update your integration to use duration to specify the length of a subscription schedule phase in the following API endpoints:
- Subscription Schedules Create
- Subscription Schedules Update
- Create an invoice preview
Using iterations in these endpoints now returns an error.
Before
After
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Command Line
Select a language
cURL
Stripe CLI
Ruby
Python
PHP
Java
Node.js
Go
.NET
No results
Changes
| Parameter | Change | Resources or endpoints |
|---|---|---|
| iterations | Removed | Invoice#create_preview. schedule_details. phases[] SubscriptionSchedule#create. phases[] SubscriptionSchedule#update. phases[] |
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-09-30. 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.
Related changes
- Promotion Codes now reference Coupons using a polymorphic field for promotions
- Adds the Discount source property and removes the Discount coupon property
- Makes flexible billing mode the default for new subscriptions
- Updates computation of subscription schedule phase end date to consider billing cycle anchor changes
- Adds customer portal configuration trial behavior
- Adds the ability to itemize proration discount amounts