Sign in

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.

Changes

Changed in 11 of the 51 revisions of this API.162725

  • 62e8dc4ed8691See the full diff
    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

  • 1e483c60b4801See the full diff
    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

  • 7b79777e9bbd2See the full diff
    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

  • c4dc6dbe947e1See the full diff
    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

  • 4b1e0a4217db1See the full diff
    • ○

      added the optional property /// to the response with the status

      response-optional-property-added

  • 9a22ca25ad2f10See the full diff
    • ●

      added the new aw_tin enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new az_tin enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new bd_bin enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new bf_ifu enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new bj_ifu enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new cm_niu enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new cv_nif enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new et_tin enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new kg_tin enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new la_tin enum value to the /// response property for the response status

      response-property-enum-value-added

    This revision's changelog hit the recording limit, so it may not list every change to this endpoint.

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • 1199cc3c557429See the full diff
    • ▲

      the response property /////////////// became optional for the status

      response-property-became-optional

    • ▲

      the response property //////////// became optional for the status

      response-property-became-optional

    • ○

      added the optional property /////////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property //////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

    This revision also has 2 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

  • b8a91ebdacb78See the full diff
    • ○

      added the optional property / to the response with the status

      response-optional-property-added

    • ○

      added the optional property //////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property //////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ///////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property ////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property //// to the response with the status

      response-optional-property-added

  • 46de5407335917See the full diff
    • ●

      added the new al_tin enum value to the /// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the /////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the ////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the /////////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the ////////////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the //////////////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the ///////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the //////////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the ////////////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the //////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the /////////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the ///////////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the ///////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the /////////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the ////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the ///////////// response property for the response status

      response-property-enum-value-added

    • ●

      added the new al_tin enum value to the /////////////// response property for the response status

      response-property-enum-value-added

    This revision's changelog hit the recording limit, so it may not list every change to this endpoint.

  • d8ab202758612See the full diff
    • ○

      added the optional property ///////// to the response with the status

      response-optional-property-added

    • ○

      added the optional property /////// to the response with the status

      response-optional-property-added

Of the 51 revisions, 14 have no diff computed and 6 have a changelog that could not be searched.