Adds expandable tax rate property to tax rate details
What’s new
You can now expand the tax_rate property within tax_rate_details on invoicing resources. Retrieve the full Tax Rate object inline instead of the tax rate ID, reducing API calls to display complete tax information.
The expandable tax_rate property is now available on:
- Invoice : total_taxes [].tax_rate_details.tax_rate and lines .data[].taxes[].tax_rate_details.tax_rate
- Invoice Line Item : taxes [].tax_rate_details.tax_rate
- Credit Note : total_taxes [].tax_rate_details.tax_rate
- Credit Note Line Item : taxes [].tax_rate_details.tax_rate
To expand the tax rate, include tax_rate_details.tax_rate in the expand parameter when retrieving these resources.
Impact
Previously, the tax_rate property returned the Tax Rate ID as a string, requiring additional API calls to fetch the full Tax Rate object details.
Now you can access complete tax rate information, including the tax percentage and display name, without making separate API calls to retrieve Tax Rate objects. This can be useful when displaying tax breakdowns on invoices or receipts because you can show detailed tax information in a single request.
Changes
| Fields | Change | From → to |
|---|---|---|
| CreditNote. total_taxes[]. tax_rate_details. tax_rate CreditNoteLineItem. taxes[]. tax_rate_details. tax_rate Invoice. total_taxes[]. tax_rate_details. tax_rate InvoiceLineItem. taxes[]. tax_rate_details. tax_rate | Changed | string → expandable($TaxRate) |
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: 2026-04-22. dahlia
- Upgrade the API version used for webhook endpoints .
- Test your integration against the new version.
- If you use Connect, test your Connect integration .
Learn more about Stripe API upgrades.