Fees report type

Review the fees report schema and parameters.

The Fees report provides a list of all the fees taken from your Stripe balance, Fee credits balance, and financial accounts. It includes fees charged by Stripe, networks, and external partners for your use of Stripe products and services. You can view a summary or an itemized report at transaction level, including attribution details. You can access fee data in this report 96 hours after a fee affects your balance. You can also download it as a CSV from the Fees report in the Dashboard.

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
`all_fees.balance_transaction_created.itemized.2`	`interval_start`, `interval_end`	`currency`, `fee_category`, `timezone`, `columns`
`all_fees.balance_transaction_created.summary.2`	`interval_start`, `interval_end`	`currency`, `columns`
`all_fees.incurred_at.itemized.2`	`interval_start`, `interval_end`	`currency`, `fee_category`, `timezone`, `columns`
`all_fees.incurred_at.summary.2`	`interval_start`, `interval_end`	`currency`, `columns`

Fees summary pivoted on balance transaction date

API report type: all_fees.balance_transaction_created.summary.2

Column name	Default	Description
`suite`		An integrated group of products offering extensive functionality within Stripe (for example, Payments, Revenue, Connect, Money Management, Platform).
`product`		A standalone offering within a suite, delivering specific capabilities to users.
`feature_name`		The name of the feature that incurred the fee.
`amount`		Total amount of the fees captured against each product feature. Expressed in major units of the currency.
`tax`		Tax on the fees included in the `amount`, expressed in major units of the currency.
`currency`		Three-letter ISO currency code of `amount` and `tax`.

Fees itemized pivoted on balance transaction date

API report type: all_fees.balance_transaction_created.itemized.2

Column name	Default	Description
`activity_end_time`		For a fee based on activity that spans a period of time, the activity’s end date in the requested time zone.
`activity_start_time`		For a fee based on activity that spans a period of time, the activity’s start date in the requested time zone.
`amount`		Amount of the fee, expressed in major units of the currency.
`balance_transaction_created`		Time at which the fee transaction affected your Stripe balance, in the requested time zone.
`balance_transaction_description`		Deprecated Description of the balance transaction containing the fee. Use the `fee_description` field instead.
`fee_description`		One-line description for the fee.
`balance_transaction_id`		ID of the balance transaction containing the fee.
`currency`		Three-letter ISO currency code of `amount` and `tax`.
`fee_transaction_created`		Creation time of the fee transaction that deducts this fee from your Stripe v1, v2, or credit balances.
`fee_transaction_id`		ID of the fee transaction that deducts this fee from your Stripe v1, v2, or credit balances.
`incurred_at`		Time of the originating event that incurred the fee, in the requested time zone.
`incurred_by`		ID of the object that incurred the fee, if any. The object type appears in the `incurred_by_type` field.
`incurred_by_type`		The type of the `incurred_by` object. It matches the object field in the API (with values such as charge, refund, or invoice).
`pricing_tier`		The pricing tier at which this fee was assessed.
`fee_category`		Deprecated Classification of the fee. This field is no longer maintained and might have incomplete data. Use the `product` and `suite` fields instead.
`settled_at`		Time at which this fee settled. For an invoice, this is the date we sent it.
`settled_via`		Transaction method used to settle this fee. Possible values are: `credit`, `balance`, `v2_balance`, `invoice`, or `multiple`.
`feature_name`		A feature is a particular functionality or attribute within a product, enabling specific user actions or solutions. This is what the fee is associated with.
`feature_description`		One line description of the feature.
`product`		A standalone offering within a suite, delivering specific capabilities to users.
`suite`		An integrated group of products offering extensive functionality within Stripe (for example, Payments, Revenue, Connect, Money Management, Platform).
`tax`		Tax on the fee, expressed in major units of the currency.

Fees summary pivoted on incurred at date

API report type: all_fees.incurred_at.summary.2

Column name	Default	Description
`suite`		An integrated group of products offering extensive functionality within Stripe (for example, Payments, Revenue, Connect, Money Management, Platform).
`product`		A product is a standalone offering within a suite, delivering specific capabilities to users.
`feature_name`		The name of the feature that incurred the fee.
`amount`		Total amount of the fees captured against each product feature. Expressed in major units of the currency.
`tax`		Tax on the fees included in the `amount`, expressed in major units of the currency.
`currency`		Three-letter ISO currency code of `amount` and `tax`.

Fees itemized pivoted on incurred at date

API report type: all_fees.incurred_at.itemized.2

Column name	Default	Description
`activity_end_time`		For a fee based on activity that spans a period of time, the activity’s end date in the requested time zone.
`activity_start_time`		For a fee based on activity that spans a period of time, the activity’s start date in the requested time zone.
`amount`		Amount of the fee, expressed in major units of the currency.
`balance_transaction_created`		Time at which the fee transaction affected your Stripe balance, in the requested time zone.
`balance_transaction_description`		Deprecated Description of the balance transaction containing the fee. Use the `fee_description` field instead.
`fee_description`		One-line description for the fee.
`balance_transaction_id`		ID of the balance transaction containing the fee.
`currency`		Three-letter ISO currency code of `amount` and `tax`.
`fee_transaction_created`		Creation time of the fee transaction that deducts this fee from your Stripe v1, v2, or credit balances.
`fee_transaction_id`		ID of the fee transaction that deducts this fee from your Stripe v1, v2, or credit balances.
`incurred_at`		Time of the originating event that incurred the fee, in the requested time zone.
`incurred_by`		ID of the object that incurred the fee, if any. The object type appears in the `incurred_by_type` field.
`incurred_by_type`		The type of the `incurred_by` object. It matches the object field in the API (with values such as charge, refund, or invoice).
`pricing_tier`		The pricing tier at which this fee was assessed.
`fee_category`		Deprecated Classification of the fee. This field is no longer maintained and might have incomplete data. Use the `product` and `suite` fields instead.
`settled_at`		Time at which this fee settled. For an invoice, this is the date we sent it.
`settled_via`		Transaction method used to settle this fee. Possible values are: `credit`, `balance`, `v2_balance`, `invoice`, or `multiple`.
`feature_name`		A feature is a particular functionality or attribute within a product, enabling specific user actions or solutions. This is what the fee is associated with.
`feature_description`		One line description of the feature.
`product`		A product is a standalone offering within a suite, delivering specific capabilities to users.
`suite`		An integrated group of products offering extensive functionality within Stripe (for example, Payments, Revenue, Connect, Money Management, Platform).
`tax`		Tax on the fee, expressed in major units of the currency.