Public preview

Enables expansion of trial offer prices Public preview

What’s new

You can now expand the end_behavior.transition.price property of Trial Offers. Previously, this property returned the price object’s ID as a string. With this change, you can now retrieve the full Price object by including end_behavior.transition.price in the expand parameter when creating or retrieving trial offers. Read more about expanding responses.

Impact

You can access complete pricing information without making separate API calls to retrieve Price objects on trial offers. When you expand the price property, you get immediate access to pricing details such as the amount, currency, billing interval and other Price object properties directly within the trial offer response.

To use this feature, include end_behavior.transition.price in the expand parameter when working with trial offers.

Command Line

Select a language

cURL

Stripe CLI

Ruby

Python

PHP

Java

Node.js

Go

.NET

No results

If you don’t use the expand parameter, the field continues to return the price ID as a string, maintaining backward compatibility with existing integrations.

Changes

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: 2026-05-27. preview

3. Upgrade the API version used for webhook endpoints .
4. Test your integration against the new version.
5. If you use Connect, test your Connect integration .

Learn more about Stripe API upgrades.

Related changes

• Billed until property on subscription items is no longer included in responses by default
• Adds the subscription pause endpoint