Sample - Stripe API
GET/v1/tax/calculations/{calculation}

Retrieve a tax calculation

Retrieves a tax calculation by identifier while it remains available. Supply calculation to select the calculation and optionally use expand for related response fields. The response includes totals, currency, tax amounts, customer details, line items, tax breakdown, and expiration information.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
calculationstringrequired
The tax calculation identifier to retrieve. Maximum 5,000 characters.
expandarray<string>optional
Specifies which response fields to expand; each value can contain up to 5,000 characters.

2 status codes
200Returns the tax calculation with total and tax amounts, lowercase ISO currency, customer details, line items, tax breakdown, tax date, expiration timestamp, and live-mode indicator.
amount_totalintegerrequired
Total amount after taxes in the [smallest currency unit](https://docs.stripe.com/currencies#minor-units).
currencystringrequired
Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).
customerstringoptional
The ID of an existing [Customer](https://docs.stripe.com/api/customers/object) used for the resource.
customer_detailsobjectrequired
expires_atintegeroptional
Timestamp of date at which the tax calculation will expire.
idstringoptional
Unique identifier for the calculation.
line_itemsobjectoptional
The list of items the customer is purchasing.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:tax.calculation
ship_from_detailsobjectoptional
The details of the ship from location, such as the address.
shipping_costobjectoptional
The shipping cost details for the calculation.
tax_amount_exclusiveintegerrequired
The amount of tax to be collected on top of the line item prices.
tax_amount_inclusiveintegerrequired
The amount of tax already included in the line item prices.
tax_breakdownarray<TaxProductResourceTaxBreakdown>required
Breakdown of individual tax amounts that add up to the total.
tax_dateintegerrequired
The calculation uses the tax rules and rates that are in effect at this timestamp. You can use a date up to 31 days in the past or up to 31 days in the future. If you use a future date, Stripe doesn't guarantee that the expected tax rules and rate being used match the actual rules and rate that will be in effect on that date. We deploy tax changes before their effective date, but not within a fixed window.
defaultError response.
errorobjectrequired

Error handling

calculation must identify the tax calculation to retrieve and must not exceed 5,000 characters; the calculation must not have expired. Each expand value must also be no more than 5,000 characters.