Tax report type
Review the Tax report schema and parameters.
The Tax report returns data related to the tax calculated and charged for your transactions, including information about the tax codes used.
The following tables define the required and optional parameters to run the report, as well as the schema of the CSV output.
Report type | Required run parameters | Optional run parameters |
---|---|---|
tax. Columns |
|
|
Itemized tax transactions![](https://b.stripecdn.com/docs-statics-srv/assets/fcc3a1c24df6fcffface6110ca4963de.svg)
API report type: tax.
Column name | Default | Description |
---|---|---|
id | Unique ID for the tax transaction. A transaction is identified by reference to an invoice, checkout session, credit note, subscription, or order. | |
type | This refers to how a transaction is processed by Stripe. Possible values are: | |
line_item_id | Unique ID for the line item associated with the tax transaction. Multiple sales taxes rates may be applied to a single line item, so you may see several rows with the same line item ID. | |
transaction_date | Date when the transaction is committed in the requested timezone. | |
tax_date | Date used to determine the tax rate. It is usually the same date as the transaction date; however, it can be different in the context of refunds. When a credit note is issued, the | |
origin_resolved_address_country | Two-letter ISO code representing the merchant country. | |
origin_resolved_address_state | Two-letter ISO code representing the merchant country subdivision. | |
destination_resolved_address_country | Two-letter ISO code representing the customer country. | |
destination_resolved_address_state | Two-letter ISO code representing the customer country subdivision. | |
country_code | Two-letter ISO code representing the situs country. | |
state_code | Two-letter ISO code representing the situs country subdivision. | |
jurisdiction_name | Imposing tax jurisdiction name. | |
jurisdiction_level | Jurisdiction level imposing the tax. | |
customer_tax_id | Customer tax ID. | |
quantity | Units sold as per the invoice. | |
quantity_decimal | Units sold as per the invoice expressed in decimal. | |
tax_code | Unique ID for the product tax code assigned to the line item. | |
tax_rate | Tax rate applied to the line item. | |
taxability | Indicates whether a line item is | |
taxability_reason | Reason for tax collection or non-collection. | |
tax_name | Local name of the applicable tax. | |
currency | Transaction currency presented to the buyer. | |
subtotal | Taxable or non-taxable amount. | |
taxable_amount | Taxable amount in the transaction currency. | |
non_taxable_amount | Non-taxable amount in the transaction currency. | |
tax_amount | Tax amount in the transaction currency. | |
total | Taxable amount plus tax or the non-taxable amount. | |
filing_currency | Filing currency for applicable registration jurisdiction. | |
filing_exchange_rate | Filing exchange rate used. | |
filing_taxable_amount | Taxable amount in filing currency. | |
filing_non_taxable_amount | Non-taxable amount in filing currency. | |
filing_tax_amount | Tax amount in filing currency. | |
filing_total | Taxable amount plus tax or non-taxable amount in filing currency. | |
credit_note_metadata[key] | Metadata associated with a Credit Note object | |
invoice_metadata[key] | Metadata associated with an Invoice object | |
refund_metadata[key] | Metadata associated with a Refund object | |
tax_transaction_metadata[key] | Metadata associated with a Tax Transaction object |