v52

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-015891,4406.1 MB

Retrieve a Calculation

Retrieves a Tax Calculation object, if the calculation hasn’t expired.

get/v1/tax/calculations/{calculation}

Path parameters

calculationstring required

Query parameters

expandstring[]

Specifies which fields in the response should be expanded.

Response

Successful response.

amount_totalinteger required

Total amount after taxes in the smallest currency unit.

currencystring required

Three-letter ISO currency code, in lowercase. Must be a supported currency.

customerstring nullable

The ID of an existing Customer used for the resource.

expires_atinteger nullable

Timestamp of date at which the tax calculation will expire.

idstring nullable

Unique identifier for the calculation.

livemodeboolean required

If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

object'tax.calculation' required

String representing the object's type. Objects of the same type share the same value.

tax_amount_exclusiveinteger required

The amount of tax to be collected on top of the line item prices.

tax_amount_inclusiveinteger required

The amount of tax already included in the line item prices.

tax_dateinteger required

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.