Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

5282 articles

Invoice line items now have unique IDs and can't be used in place of a subscription


Breaking changes

Invoice line items now have unique IDs and can't be used in place of a subscription Breaking changes

What’s new

The id field of invoice line items of type=subscription can no longer be interpreted as a subscription ID. It’s now a unique invoice line item ID, which you can use for pagination.

Impact

This change alters the meaning of the id field for subscription-type invoice line items, making it a unique identifier for the line item itself rather than a subscription ID. You can now use this id for pagination purposes when working with invoice line items. This might require updates to existing code that relies on interpreting these id values as subscription IDs.

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: 2018-05-21
  1. Upgrade the API version used for webhook endpoints .
  2. Test your integration against the new version.
  3. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.

Last verified 2026-09-25

Is this helpful?