Attributes
- idnullable string
Unique identifier for the calculation.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- amount_
totalinteger Total amount after taxes in the smallest currency unit.
- currencystring
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customer_
detailsobject The customer’s details, such as address and tax IDs.
- customer_details.
addressnullable object The customer’s postal address (for example, home or business location).
- customer_details.
address. citynullable string City, district, suburb, town, or village.
- customer_details.
address. countrystring Two-letter country code (ISO 3166-1 alpha-2).
- customer_details.
address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- customer_details.
address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- customer_details.
address. postal_ codenullable string ZIP or postal code.
- customer_details.
address. statenullable string State/province as an ISO 3166-2 subdivision code, without country prefix. Example: “NY” or “TX”.
- customer_details.
address_ sourcenullable enum The type of customer address provided.
Possible enum valuesbilling
Denotes the address as billing address.
shipping
Denotes the address as shipping address.
- customer_details.
ip_ addressnullable string The customer’s IP address (IPv4 or IPv6).
- customer_details.
tax_ idsarray of objects The customer’s tax IDs (for example, EU VAT numbers).
- customer_details.
tax_ids. typeenum The type of the tax ID, one of
ad_
,nrt ar_
,cuit eu_
,vat bo_
,tin br_
,cnpj br_
,cpf cn_
,tin co_
,nit cr_
,tin do_
,rcn ec_
,ruc eu_
,oss_ vat hr_
,oib pe_
,ruc ro_
,tin rs_
,pib sv_
,nit uy_
,ruc ve_
,rif vn_
,tin gb_
,vat nz_
,gst au_
,abn au_
,arn in_
,gst no_
,vat no_
,voec za_
,vat ch_
,vat mx_
,rfc sg_
,uen ru_
,inn ru_
,kpp ca_
,bn hk_
,br es_
,cif tw_
,vat th_
,vat jp_
,cn jp_
,rn jp_
,trn li_
,uid li_
,vat my_
,itn us_
,ein kr_
,brn ca_
,qst ca_
,gst_ hst ca_
,pst_ bc ca_
,pst_ mb ca_
,pst_ sk my_
,sst sg_
,gst ae_
,trn cl_
,tin sa_
,vat id_
,npwp my_
,frp il_
,vat ge_
,vat ua_
,vat is_
,vat bg_
,uic hu_
,tin si_
,tin ke_
,pin tr_
,tin eg_
,tin ph_
,tin al_
,tin bh_
,vat kz_
,bin ng_
,tin om_
,vat de_
,stn ch_
,uid tz_
,vat uz_
,vat uz_
,tin md_
,vat ma_
,vat by_
,tin ao_
,tin bs_
,tin bb_
,tin cd_
,nif mr_
,nif me_
,pib zw_
,tin ba_
,tin gn_
,nif mk_
,vat sr_
,fin sn_
,ninea am_
,tin np_
,pan tj_
,tin ug_
,tin zm_
,tin kh_
,tin aw_
,tin az_
,tin bd_
,bin bj_
,ifu et_
,tin kg_
,tin la_
,tin cm_
,niu cv_
,nif bf_
, orifu unknown
Possible enum valuesad_
nrt ae_
trn al_
tin am_
tin ao_
tin ar_
cuit au_
abn au_
arn aw_
tin az_
tin Show 101 more - customer_details.
tax_ids. valuestring The value of the tax ID.
- customer_details.
taxability_ overrideenum The taxability override used for taxation.
Possible enum valuescustomer_
exempt The customer is exempt of tax.
none
No taxability override (default).
reverse_
charge The customer is entitled to reverse charge tax treatment.
- expires_
atnullable timestamp Timestamp of date at which the tax calculation will expire.
- line_
itemsnullable objectExpandable The list of items the customer is purchasing.
- line_items.
objectstring String representing the object’s type. Objects of the same type share the same value. Always has the value
list
. - line_items.
dataarray of objects Details about each object.
- line_items.
data. idstring Unique identifier for the object.
- line_items.
data. objectstring String representing the object’s type. Objects of the same type share the same value.
- line_items.
data. amountinteger The line item amount in the smallest currency unit. If
tax_
, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.behavior=inclusive - line_items.
data. amount_ taxinteger The amount of tax calculated for this line item, in the smallest currency unit.
- line_items.
data. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - line_items.
data. metadatanullable object Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
- line_items.
data. productnullable string The ID of an existing Product.
- line_items.
data. quantityinteger The number of units of the item being purchased. For reversals, this is the quantity reversed.
- line_items.
data. referencestring A custom identifier for this line item.
- line_items.
data. tax_ behaviorenum Specifies whether the
amount
includes taxes. Iftax_
, then the amount includes taxes.behavior=inclusive Possible enum valuesexclusive
Taxes are calculated on top of the line item amount (default).
inclusive
Taxes are included in the line item amount.
- line_items.
data. tax_ breakdownnullable array of objectsExpandable Detailed account of taxes relevant to this line item.
- line_items.
data. tax_breakdown. amountinteger The amount of tax, in the smallest currency unit.
- line_items.
data. tax_breakdown. jurisdictionobject The jurisdiction in which tax is imposed.
- line_items.
data. tax_breakdown. jurisdiction. countrystring Two-letter country code (ISO 3166-1 alpha-2).
- line_items.
data. tax_breakdown. jurisdiction. display_ namestring A human-readable name for the jurisdiction imposing the tax.
- line_items.
data. tax_breakdown. jurisdiction. levelenum Indicates the level of the jurisdiction imposing the tax.
Possible enum valuescity
Level pertaining to city (e.g. Chicago)
country
Level pertaining to country (e.g. United States, Ireland, etc.)
county
Level pertaining to county (e.g. Cook)
district
Level pertaining to district (e.g. Roseland)
state
Level pertaining to state (e.g. Illinois)
- line_items.
data. tax_breakdown. jurisdiction. statenullable string ISO 3166-2 subdivision code, without country prefix. For example, “NY” for New York, United States.
- line_items.
data. tax_breakdown. sourcingenum Indicates whether the jurisdiction was determined by the origin (merchant’s address) or destination (customer’s address).
Possible enum valuesdestination
The tax is calculated at the customer’s address.
origin
The tax is calculated at one of your addresses, for example the main establishment.
- line_items.
data. tax_breakdown. tax_ rate_ detailsnullable object Details regarding the rate for this tax. This field will be
null
when the tax is not imposed, for example if the product is exempt from tax.- line_items.
data. tax_breakdown. tax_rate_details. display_ namestring A localized display name for tax type, intended to be human-readable. For example, “Local Sales and Use Tax”, “Value-added tax (VAT)”, or “Umsatzsteuer (USt.)”.
- line_items.
data. tax_breakdown. tax_rate_details. percentage_ decimalstring The tax rate percentage as a string. For example, 8.5% is represented as “8.5”.
- line_items.
data. tax_breakdown. tax_rate_details. tax_ typeenum The tax type, such as
vat
orsales_
.tax Possible enum valuesamusement_
tax Amusement Tax
communications_
tax Communications Tax
gst
Goods and Services Tax
hst
Harmonized Sales Tax
igst
Integrated Goods and Services Tax
jct
Japanese Consumption Tax
lease_
tax Chicago Lease Tax
pst
Provincial Sales Tax
qst
Quebec Sales Tax
retail_
delivery_ fee Retail Delivery Fee
Show 4 more
- line_items.
data. tax_breakdown. taxability_ reasonenum The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
Possible enum valuescustomer_
exempt No tax is applied as the customer is exempt from tax.
not_
collecting No tax is collected either because you are not registered to collect tax in this jurisdiction, or because the non-taxable product tax code (
txcd_
) was used.00000000 not_
subject_ to_ tax No tax is imposed on this transaction.
not_
supported No tax applied. Stripe doesn’t support this jurisdiction, territory, or product.
portion_
product_ exempt A portion of the price is exempt from tax.
portion_
reduced_ rated A portion of the price is taxed at a reduced rate.
portion_
standard_ rated A portion of the price is taxed at the standard rate.
product_
exempt The product or service is nontaxable or exempt from tax.
product_
exempt_ holiday The product or service is not taxed due to a sales tax holiday.
proportionally_
rated The shipping cost tax rate is calculated as a weighted average of the other line items’ rates, weighted by their amounts.
Show 5 more - line_items.
data. tax_breakdown. taxable_ amountinteger The amount on which tax is calculated, in the smallest currency unit.
- line_items.
data. tax_ codestring The tax code ID used for this resource.
- line_items.
has_ moreboolean True if this list has another page of items after this one that can be fetched.
- line_items.
urlstring The URL where this list can be accessed.
- shipping_
costnullable object The shipping cost details for the calculation.
- shipping_cost.
amountinteger The shipping amount in the smallest currency unit. If
tax_
, then this amount includes taxes. Otherwise, taxes were calculated on top of this amount.behavior=inclusive - shipping_cost.
amount_ taxinteger The amount of tax calculated for shipping, in the smallest currency unit.
- shipping_cost.
shipping_ ratenullable string The ID of an existing ShippingRate.
- shipping_cost.
tax_ behaviorenum Specifies whether the
amount
includes taxes. Iftax_
, then the amount includes taxes.behavior=inclusive Possible enum valuesexclusive
Taxes are calculated on top of the shipping cost amount (default).
inclusive
Taxes are included in the shipping cost amount.
- shipping_cost.
tax_ breakdownnullable array of objectsExpandable Detailed account of taxes relevant to shipping cost.
- shipping_cost.
tax_breakdown. amountinteger The amount of tax, in the smallest currency unit.
- shipping_cost.
tax_breakdown. jurisdictionobject The jurisdiction in which tax is imposed.
- shipping_cost.
tax_breakdown. jurisdiction. countrystring Two-letter country code (ISO 3166-1 alpha-2).
- shipping_cost.
tax_breakdown. jurisdiction. display_ namestring A human-readable name for the jurisdiction imposing the tax.
- shipping_cost.
tax_breakdown. jurisdiction. levelenum Indicates the level of the jurisdiction imposing the tax.
Possible enum valuescity
Level pertaining to city (e.g. Chicago)
country
Level pertaining to country (e.g. United States, Ireland, etc.)
county
Level pertaining to county (e.g. Cook)
district
Level pertaining to district (e.g. Roseland)
state
Level pertaining to state (e.g. Illinois)
- shipping_cost.
tax_breakdown. jurisdiction. statenullable string ISO 3166-2 subdivision code, without country prefix. For example, “NY” for New York, United States.
- shipping_cost.
tax_breakdown. sourcingenum Indicates whether the jurisdiction was determined by the origin (merchant’s address) or destination (customer’s address).
Possible enum valuesdestination
The tax is calculated at the customer’s address.
origin
The tax is calculated at one of your addresses, for example the main establishment.
- shipping_cost.
tax_breakdown. tax_ rate_ detailsnullable object Details regarding the rate for this tax. This field will be
null
when the tax is not imposed, for example if the product is exempt from tax.- shipping_cost.
tax_breakdown. tax_rate_details. display_ namestring A localized display name for tax type, intended to be human-readable. For example, “Local Sales and Use Tax”, “Value-added tax (VAT)”, or “Umsatzsteuer (USt.)”.
- shipping_cost.
tax_breakdown. tax_rate_details. percentage_ decimalstring The tax rate percentage as a string. For example, 8.5% is represented as “8.5”.
- shipping_cost.
tax_breakdown. tax_rate_details. tax_ typeenum The tax type, such as
vat
orsales_
.tax Possible enum valuesamusement_
tax Amusement Tax
communications_
tax Communications Tax
gst
Goods and Services Tax
hst
Harmonized Sales Tax
igst
Integrated Goods and Services Tax
jct
Japanese Consumption Tax
lease_
tax Chicago Lease Tax
pst
Provincial Sales Tax
qst
Quebec Sales Tax
retail_
delivery_ fee Retail Delivery Fee
Show 4 more
- shipping_cost.
tax_breakdown. taxability_ reasonenum The reasoning behind this tax, for example, if the product is tax exempt. The possible values for this field may be extended as new tax rules are supported.
Possible enum valuescustomer_
exempt No tax is applied as the customer is exempt from tax.
not_
collecting No tax is collected either because you are not registered to collect tax in this jurisdiction, or because the non-taxable product tax code (
txcd_
) was used.00000000 not_
subject_ to_ tax No tax is imposed on this transaction.
not_
supported No tax applied. Stripe doesn’t support this jurisdiction, territory, or product.
portion_
product_ exempt A portion of the price is exempt from tax.
portion_
reduced_ rated A portion of the price is taxed at a reduced rate.
portion_
standard_ rated A portion of the price is taxed at the standard rate.
product_
exempt The product or service is nontaxable or exempt from tax.
product_
exempt_ holiday The product or service is not taxed due to a sales tax holiday.
proportionally_
rated The shipping cost tax rate is calculated as a weighted average of the other line items’ rates, weighted by their amounts.
Show 5 more - shipping_cost.
tax_breakdown. taxable_ amountinteger The amount on which tax is calculated, in the smallest currency unit.
- shipping_cost.
tax_ codestring The tax code ID used for shipping.
- tax_
amount_ exclusiveinteger The amount of tax to be collected on top of the line item prices.
- tax_
amount_ inclusiveinteger The amount of tax already included in the line item prices.
- tax_
breakdownarray of objects Breakdown of individual tax amounts that add up to the total.
- tax_breakdown.
amountinteger The amount of tax, in the smallest currency unit.
- tax_breakdown.
inclusiveboolean Specifies whether the tax amount is included in the line item amount.
- tax_breakdown.
tax_ rate_ detailsobject Details of the applied tax rate, such as type, percentage, state and country.
- tax_breakdown.
tax_rate_details. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- tax_breakdown.
tax_rate_details. flat_ amountnullable object The amount of the tax rate when the
rate_
istype flat_
. Tax rates withamount rate_
type percentage
can vary based on the transaction, resulting in this field beingnull
. This field exposes the amount and currency of the flat tax rate.- tax_breakdown.
tax_rate_details. flat_amount. amountinteger Amount of the tax when the
rate_
istype flat_
. This positive integer represents how much to charge in the smallest currency unit (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).amount - tax_breakdown.
tax_rate_details. flat_amount. currencystring Three-letter ISO currency code, in lowercase.
- tax_breakdown.
tax_rate_details. percentage_ decimalstring The tax rate percentage as a string. For example, 8.5% is represented as
"8.
.5" - tax_breakdown.
tax_rate_details. rate_ typenullable enum Indicates the type of tax rate applied to the taxable amount. This value can be
null
when no tax applies to the location. This field is only present for TaxRates created by Stripe Tax.Possible enum valuesflat_
amount A fixed amount applied as tax, regardless of the taxable amount, such as a retail delivery fee.
percentage
A tax rate expressed as a percentage of the taxable amount, such as the sales tax rate in California.
- tax_breakdown.
tax_rate_details. statenullable string State, county, province, or region.
- tax_breakdown.
tax_rate_details. tax_ typenullable enum The tax type, such as
vat
orsales_
.tax Possible enum valuesamusement_
tax Amusement Tax
communications_
tax Communications Tax
gst
Goods and Services Tax
hst
Harmonized Sales Tax
igst
Integrated Goods and Services Tax
jct
Japanese Consumption Tax
lease_
tax Chicago Lease Tax
pst
Provincial Sales Tax
qst
Quebec Sales Tax
retail_
delivery_ fee Retail Delivery Fee
Show 4 more
- tax_breakdown.
taxability_ reasonenum The reasoning behind this tax, for example, if the product is tax exempt. We might extend the possible values for this field to support new tax rules.
Possible enum valuescustomer_
exempt No tax is applied as the customer is exempt from tax.
not_
collecting No tax is collected either because you are not registered to collect tax in this jurisdiction, or because the non-taxable product tax code (
txcd_
) was used.00000000 not_
subject_ to_ tax No tax is imposed on this transaction.
not_
supported No tax applied. Stripe doesn’t support this jurisdiction, territory, or product.
portion_
product_ exempt A portion of the price is exempt from tax.
portion_
reduced_ rated A portion of the price is taxed at a reduced rate.
portion_
standard_ rated A portion of the price is taxed at the standard rate.
product_
exempt The product or service is nontaxable or exempt from tax.
product_
exempt_ holiday The product or service is not taxed due to a sales tax holiday.
proportionally_
rated The shipping cost tax rate is calculated as a weighted average of the other line items’ rates, weighted by their amounts.
Show 5 more - tax_breakdown.
taxable_ amountinteger The amount on which tax is calculated, in the smallest currency unit.
More attributes
- customernullable string
The ID of an existing Customer used for the resource.
- livemodeboolean
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - ship_
from_ detailsnullable object The details of the ship from location, such as the address.
- ship_from_details.
addressobject The address from which the goods in the transaction are shipped from.
- ship_from_details.
address. citynullable string City, district, suburb, town, or village.
- ship_from_details.
address. countrystring Two-letter country code (ISO 3166-1 alpha-2).
- ship_from_details.
address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- ship_from_details.
address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- ship_from_details.
address. postal_ codenullable string ZIP or postal code.
- ship_from_details.
address. statenullable string State/province as an ISO 3166-2 subdivision code, without country prefix. Example: “NY” or “TX”.
- tax_
datetimestamp Timestamp of date at which the tax rules and rates in effect applies for the calculation.
{ "id": "taxcalc_1OduxkBUZ691iUZ4iWvpMApI", "object": "tax.calculation", "amount_total": 1953, "currency": "usd", "customer": null, "customer_details": { "address": { "city": "Seattle", "country": "US", "line1": "920 5th Ave", "line2": null, "postal_code": "98104", "state": "WA" }, "address_source": "shipping", "ip_address": null, "tax_ids": [], "taxability_override": "none" }, "expires_at": 1706708005, "line_items": { "object": "list", "data": [ { "id": "tax_li_PSqf3RMNZa23H4", "object": "tax.calculation_line_item", "amount": 1499, "amount_tax": 154, "livemode": false, "product": null, "quantity": 1, "reference": "Music Streaming Coupon", "tax_behavior": "exclusive", "tax_code": "txcd_10000000" } ], "has_more": false, "total_count": 1, "url": "/v1/tax/calculations/taxcalc_1OduxkBUZ691iUZ4iWvpMApI/line_items" }, "livemode": false, "ship_from_details": null, "shipping_cost": { "amount": 300, "amount_tax": 0, "tax_behavior": "exclusive", "tax_code": "txcd_92010001" }, "tax_amount_exclusive": 154, "tax_amount_inclusive": 0, "tax_breakdown": [ { "amount": 154, "inclusive": false, "tax_rate_details": { "country": "US", "percentage_decimal": "10.25", "state": "WA", "tax_type": "sales_tax" }, "taxability_reason": "standard_rated", "taxable_amount": 1499 }, { "amount": 0, "inclusive": false, "tax_rate_details": { "country": "DE", "percentage_decimal": "0.0", "state": null, "tax_type": "vat" }, "taxability_reason": "zero_rated", "taxable_amount": 300 } ], "tax_date": 1706535204}