Stripe invoice and credit note retrieval expands tax_rate_details.tax_rate
Introduced 2026-04-22 · score 0.93
HOW TO USE IT
When implementing invoice or credit note tax breakdowns on API version `2026-04-22.dahlia`, retrieve the resource with `expand[]=tax_rate_details.tax_rate` to receive the full Tax Rate object inline. The field applies to invoice and credit note total taxes and line taxes, and to invoice and credit note line items.
curl -G https://api.stripe.com/v1/invoices/<invoice_id> -u "$STRIPE_SECRET_KEY:" -d 'expand[]=tax_rate_details.tax_rate'curl -G https://api.stripe.com/v1/credit_notes/<credit_note_id> -u "$STRIPE_SECRET_KEY:" -d 'expand[]=tax_rate_details.tax_rate'WHY THIS HELPS
When implementing invoice or credit note tax breakdowns, retrieve the full tax rate details with the resource.
BEFORE THIS CHANGE
Previously, `tax_rate` returned the Tax Rate ID as a string, requiring additional API calls to retrieve the full Tax Rate object.
REQUIREMENTS AND LIMITATIONS
- expand[]: Expansion request parameter; set its value to `tax_rate_details.tax_rate` to expand that property.
- tax_rate_details.tax_rate: Expandable Tax Rate property on invoice total taxes and line taxes, invoice line item taxes, credit note total taxes, and credit note line item taxes.
- Prerequisite: Use API version `2026-04-22.dahlia` or later for this change. For REST requests, set the `Stripe-Version` header to `2026-04-22.dahlia`.
- Prerequisite: Authenticate API requests with a Stripe secret key.
- Applies to Invoice total_taxes and line taxes, Invoice Line Item taxes, Credit Note total_taxes, and Credit Note Line Item taxes.
FIRST-PARTY EVIDENCE
- https://docs.stripe.com/changelog/dahlia/2026-04-22/adds-expandable-tax-rate-property-to-tax-rate-details
- https://docs.stripe.com/api/invoices/retrieve?api-version=2026-04-22.dahlia
- https://docs.stripe.com/api/credit_notes/retrieve?api-version=2026-04-22.dahlia
Check the installed version and the source before using it. Entry JSON