Deprecates total count expansion for list API methodsBreaking changes

What’s new

You can no longer expand the total_count property in lists. New users can’t expand total_count on earlier Stripe versions. Attempting to expand total_count returns a 400 error with a property_forbidden error message.

Why is this a breaking change?

We don’t allow requests for total_count expansion for list API methods. To use this version, you must migrate your integration to solely rely on the has_more list response field instead.

Impact

If your integration uses total_count for pagination and it sends include[]=total_count or exclude[]=total_count API parameters with your API request, you need to update your pagination integration to rely only on the has_more response field.

Some top-level API resources always return total_count values for some of their list fields. You might notice this if you don’t add include[]=total_count or exclude[]=total_count to your request but you still receive total_count data as a part of the response. These API resources aren’t affected by this version change.

Upgrade