Stripe | Financial Infrastructure to Grow Your Revenue

Stripe | Financial Infrastructure to Grow Your Revenue

4466 articles

Balance report type


Balance report type

Review the Balance report schema and parameters.

The Balance report returns your complete transaction history to help with reconciliation. Run this report to use the returned data in your API calls. You can also download the CSV from the Balance 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 typeRequired run parametersOptional run parameters
balance_change_from_activity.itemized.6 Columnsinterval_start interval_endcurrency reporting_category decimal_separator columns
balance_change_from_activity.itemized.7 Columnsinterval_start interval_endtimezone currency reporting_category decimal_separator columns
balance_change_from_activity.summary.2 Columnsinterval_start interval_endcurrency timezone columns
balance_change_from_activity.itemized.1 Columnsinterval_start interval_endcurrency reporting_category decimal_separator columns
balance_change_from_activity.itemized.2 Columnsinterval_start interval_endcurrency reporting_category decimal_separator columns
balance_change_from_activity.itemized.3 Columnsinterval_start interval_endtimezone currency reporting_category decimal_separator columns
balance_change_from_activity.summary.1 Columnsinterval_start interval_endcurrency timezone columns
payouts.itemized.1 Columnsinterval_start interval_endcurrency reporting_category decimal_separator columns
payouts.itemized.2 Columnsinterval_start interval_endcurrency reporting_category decimal_separator columns
payouts.itemized.3 Columnsinterval_start interval_endtimezone currency reporting_category decimal_separator columns
payouts.summary.1 Columnsinterval_start interval_endcurrency timezone columns
balance.summary.1 Columnsinterval_start interval_endtimezone currency columns
payouts.itemized.4 Columnsinterval_start interval_endcurrency reporting_category decimal_separator columns
payouts.itemized.5 Columnsinterval_start interval_endtimezone currency reporting_category decimal_separator columns
payouts.summary.2 Columnsinterval_start interval_endcurrency timezone columns

Itemized balance change from activity

API report type: balance_change_from_activity.itemized.6

Column nameDefaultDescription
automatic_payout_effective_atThe date we expect this automatic payout to arrive in your bank account, in UTC. This is also when the paid-out funds are deducted from your Stripe balance.
automatic_payout_idID of the automatically created payout associated with this balance transaction (only set if your account is on an automatic payout schedule).
available_on_utcThe date the balance transaction’s net funds will become available in the Stripe balance. Dates in UTC.
balance_transaction_idUnique identifier for the balance transaction.
balance_typeThe type of balance this transaction belongs to (for example, payments, issuing, corporate_card).
card_address_cityCity of the card address associated with this charge, if any
card_address_countryCountry of the card address associated with this charge, if any
card_address_line1First line of the card address associated with this charge, if any
card_address_line2Second line of the card address associated with this charge, if any
card_address_postal_codePostal code of the card address associated with this charge, if any
card_address_stateState of the card address associated with this charge, if any
card_brandCard brand, if applicable.
card_countryTwo-letter ISO code representing the country of the card.
card_fundingCard funding type, if applicable.
charge_created_utcCreation time of the original charge associated with this balance transaction. Available for charges, refunds and disputes. For charges that were separately authorized and captured, this is the authorization time. Dates in UTC.
charge_idUnique identifier for the original charge associated with this balance transaction. Available for charges, refunds and disputes.
connected_account_countryFor Stripe Connect activity related to a connected account, the two-letter ISO code representing the country of the account.
connected_account_direct_charge_id(Beta) For Stripe Connect activity related to a connected account, charge id of the direct charge that happened on connected account.
connected_account_idFor Stripe Connect activity related to a connected account, the unique ID for the account.
connected_account_nameFor Stripe Connect activity related to a connected account, the name of the account.
created_utcTime at which the balance transaction was created. Dates in UTC.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
customer_address_cityCity of the customer address associated with this charge, if any
customer_address_countryCountry of the customer address associated with this charge, if any
customer_address_line1First line of the customer address associated with this charge, if any
customer_address_line2Second line of the customer address associated with this charge, if any
customer_address_postal_codePostal code of the customer address associated with this charge, if any
customer_address_stateState of the customer address associated with this charge, if any
customer_descriptionDescription provided when creating the customer, often used to store the customer name.
customer_emailEmail address of the customer, if any, associated with this balance transaction.
customer_facing_amountFor transactions associated with charges, refunds, or disputes, the amount of the original charge, refund, or dispute. If the customer was charged in a different currency than your account’s default, this field will reflect the amount as seen by the customer.
customer_facing_currencyFor transactions associated with charges, refunds, or disputes, the three-letter ISO currency code for customer_facing_amount.
customer_idThe unique ID of the related customer, if any.
customer_nameName of the customer, if any, associated with this balance transaction.
customer_shipping_address_cityCity of the customer shipping address associated with this charge, if any
customer_shipping_address_countryCountry of the customer shipping address associated with this charge, if any
customer_shipping_address_line1First line of the customer shipping address associated with this charge, if any
customer_shipping_address_line2Second line of the customer shipping address associated with this charge, if any
customer_shipping_address_postal_codePostal code of the customer shipping address associated with this charge, if any
customer_shipping_address_stateState of the customer shipping address associated with this charge, if any
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
dispute_reasonReason given by cardholder for dispute. Read more about dispute reasons.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
fee_net_of_withheld_taxThe Stripe processing fee after removing withheld tax. Calculated as fee minus withheld_tax — represents Stripe’s actual processing charge excluding any tax withheld.
fee_transaction_idFee Transaction ID associated with the credit.
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
invoice_idUnique ID for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
invoice_numberUnique Number for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
is_linkWhether or not the payment was made using Link.
is_managed_paymentsWhether this transaction was processed through Stripe Managed Payments. True when the charge was handled via Stripe Managed Payments, regardless of whether any tax was withheld.
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payment_intent_idThe unique ID of the related Payment Intent, if any.
payment_metadata[key]Metadata associated with the related PaymentIntent, if any. If no PaymentIntent metadata exists, metadata from any related charge object will be returned. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
payment_method_typeThe type of payment method used in the related payment.
payout_reference_tokenA unique reference token that displays on the beneficiary’s bank statement.
payout_statement_descriptorExtra information that displays on the recipient’s bank statement. Most banks truncate this information and display it inconsistently. Some banks might not display it at all.
refund_metadata[key]Metadata associated with the related refund object, if any. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
regulatory_tag​​An identifier reflecting the classification of this transaction according to local regulations, if applicable. Accounts with automatic payouts enabled receive a separate payout for each regulatory tag. ​​This column is only populated for Brazilian accounts.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
shipping_address_cityCity of the shipping address associated with this charge, if any
shipping_address_countryCountry of the shipping address associated with this charge, if any
shipping_address_line1First line of the shipping address associated with this charge, if any
shipping_address_line2Second line of the shipping address associated with this charge, if any
shipping_address_postal_codePostal code of the shipping address associated with this charge, if any
shipping_address_stateState of the shipping address associated with this charge, if any
source_idThe Stripe object to which this transaction is related.
statement_descriptorThe dynamic statement descriptor or suffix specified when the related charge was created.
subscription_idUnique ID for the subscription associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing subscription.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.
transfer_metadata[key]Metadata associated with the related transfer object, if any. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
withheld_taxSales tax, VAT or GST withheld. This amount is already included within the fee column.

Itemized balance change from activity

API report type: balance_change_from_activity.itemized.7

Column nameDefaultDescription
application_feeApplication fee paid to your platform, only relevant for standard connected accounts.
automatic_payout_effective_atThe date we expect this automatic payout to arrive in your bank account, in the requested timezone, or UTC if not provided. This is also when the paid-out funds are deducted from your Stripe balance.
automatic_payout_effective_at_utcThe date we expect this automatic payout to arrive in your bank account, in UTC. This is also when the paid-out funds are deducted from your Stripe balance.
automatic_payout_idID of the automatically created payout associated with this balance transaction (only set if your account is on an automatic payout schedule).
available_onThe date the balance transaction’s net funds will become available in the Stripe balance. Dates in the requested timezone, or UTC if not provided.
available_on_utcThe date the balance transaction’s net funds will become available in the Stripe balance. Dates in UTC.
balance_transaction_idUnique identifier for the balance transaction.
balance_typeThe type of balance this transaction belongs to (for example, payments, issuing, corporate_card).
card_address_cityCity of the card address associated with this charge, if any
card_address_countryCountry of the card address associated with this charge, if any
card_address_line1First line of the card address associated with this charge, if any
card_address_line2Second line of the card address associated with this charge, if any
card_address_postal_codePostal code of the card address associated with this charge, if any
card_address_stateState of the card address associated with this charge, if any
card_brandCard brand, if applicable.
card_countryTwo-letter ISO code representing the country of the card.
card_fundingCard funding type, if applicable.
card_networkCard network, if applicable.
charge_createdCreation time of the original charge associated with this balance transaction. Available for charges, refunds and disputes. For charges that were separately authorized and captured, this is the authorization time. Dates in the requested timezone, or UTC if not provided.
charge_created_utcCreation time of the original charge associated with this balance transaction. Available for charges, refunds and disputes. For charges that were separately authorized and captured, this is the authorization time. Dates in UTC.
charge_idUnique identifier for the original charge associated with this balance transaction. Available for charges, refunds and disputes.
connected_account_countryFor Stripe Connect activity related to a connected account, the two-letter ISO code representing the country of the account.
connected_account_direct_charge_id(Beta) For Stripe Connect activity related to a connected account, charge id of the direct charge that happened on connected account.
connected_account_idFor Stripe Connect activity related to a connected account, the unique ID for the account.
connected_account_nameFor Stripe Connect activity related to a connected account, the name of the account.
countryTwo-letter ISO code representing the country associated with the transaction. For card payments, this is determined from the card country or billing address. For other payment methods, this is determined by the payment method type (e.g., US for ACH, IN for UPI).
createdTime at which the balance transaction was created. Dates in the requested timezone, or UTC if not provided.
created_utcTime at which the balance transaction was created. Dates in UTC.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
customer_address_cityCity of the customer address associated with this charge, if any
customer_address_countryCountry of the customer address associated with this charge, if any
customer_address_line1First line of the customer address associated with this charge, if any
customer_address_line2Second line of the customer address associated with this charge, if any
customer_address_postal_codePostal code of the customer address associated with this charge, if any
customer_address_stateState of the customer address associated with this charge, if any
customer_descriptionDescription provided when creating the customer, often used to store the customer name.
customer_emailEmail address of the customer, if any, associated with this balance transaction.
customer_facing_amountFor transactions associated with charges, refunds, or disputes, the amount of the original charge, refund, or dispute. If the customer was charged in a different currency than your account’s default, this field will reflect the amount as seen by the customer.
customer_facing_currencyFor transactions associated with charges, refunds, or disputes, the three-letter ISO currency code for customer_facing_amount.
customer_idThe unique ID of the related customer, if any.
customer_nameName of the customer, if any, associated with this balance transaction.
customer_shipping_address_cityCity of the customer shipping address associated with this charge, if any
customer_shipping_address_countryCountry of the customer shipping address associated with this charge, if any
customer_shipping_address_line1First line of the customer shipping address associated with this charge, if any
customer_shipping_address_line2Second line of the customer shipping address associated with this charge, if any
customer_shipping_address_postal_codePostal code of the customer shipping address associated with this charge, if any
customer_shipping_address_stateState of the customer shipping address associated with this charge, if any
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
dispute_reasonReason given by cardholder for dispute. Read more about dispute reasons.
exchange_ratecaptures the foreign exchange rate applied to a balance transaction
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
fee_net_of_withheld_taxThe Stripe processing fee after removing withheld tax. Calculated as fee minus withheld_tax — represents Stripe’s actual processing charge excluding any tax withheld.
fee_transaction_idFee Transaction ID associated with the credit.
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
invoice_idUnique ID for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
invoice_numberNumber for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
is_linkWhether or not the payment was made using Link.
is_managed_paymentsWhether this transaction was processed through Stripe Managed Payments. True when the charge was handled via Stripe Managed Payments, regardless of whether any tax was withheld.
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payment_intent_idThe unique ID of the related Payment Intent, if any.
payment_metadata[key]Metadata associated with the related PaymentIntent, if any. If no PaymentIntent metadata exists, metadata from any related charge object will be returned. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
payment_method_typeThe type of payment method used in the related payment.
payout_reference_tokenA unique reference token that displays on the beneficiary’s bank statement.
payout_statement_descriptorExtra information that displays on the recipient’s bank statement. Most banks truncate this information and display it inconsistently. Some banks might not display it at all.
product_idsList of product IDs associated with this balance transaction.
product_namesList of product names associated with this balance transaction.
refund_metadata[key]Metadata associated with the related refund object, if any. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
regulatory_tag​​An identifier reflecting the classification of this transaction according to local regulations, if applicable. Accounts with automatic payouts enabled receive a separate payout for each regulatory tag. ​​This column is only populated for Brazilian accounts.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
shipping_address_cityCity of the shipping address associated with this charge, if any
shipping_address_countryCountry of the shipping address associated with this charge, if any
shipping_address_line1First line of the shipping address associated with this charge, if any
shipping_address_line2Second line of the shipping address associated with this charge, if any
shipping_address_postal_codePostal code of the shipping address associated with this charge, if any
shipping_address_stateState of the shipping address associated with this charge, if any
source_idThe Stripe object to which this transaction is related.
statement_descriptorThe dynamic statement descriptor or suffix specified when the related charge was created.
subscription_idUnique ID for the subscription associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing subscription.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.
transfer_metadata[key]Metadata associated with the related transfer object, if any. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
withheld_taxSales tax, VAT or GST withheld. This amount is already included within the fee column.

Balance change from activity summary

API report type: balance_change_from_activity.summary.2

Column nameDefaultDescription
countThe number of transactions associated with the reporting_category.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
feeSum of the fees paid for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossSum of the gross amounts of the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netSum of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.

Itemized balance change from activity

API report type: balance_change_from_activity.itemized.1

Column nameDefaultDescription
automatic_payout_effective_atThe date we expect this automatic payout to arrive in your bank account, in UTC. This is also when the paid-out funds are deducted from your Stripe balance.
automatic_payout_idID of the automatically created payout associated with this balance transaction (only set if your account is on an automatic payout schedule).
available_on_utcThe date the balance transaction’s net funds will become available in the Stripe balance. Dates in UTC.
balance_transaction_idUnique identifier for the balance transaction.
card_brandCard brand, if applicable.
card_countryTwo-letter ISO code representing the country of the card.
card_fundingCard funding type, if applicable.
charge_created_utcCreation time of the original charge associated with this balance transaction. Available for charges, refunds and disputes. For charges that were separately authorized and captured, this is the authorization time. Dates in UTC.
charge_idUnique identifier for the original charge associated with this balance transaction. Available for charges, refunds and disputes.
created_utcTime at which the balance transaction was created. Dates in UTC.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
customer_descriptionDescription provided when creating the customer, often used to store the customer name.
customer_emailEmail address of the customer, if any, associated with this balance transaction.
customer_facing_amountFor transactions associated with charges, refunds, or disputes, the amount of the original charge, refund, or dispute. If the customer was charged in a different currency than your account’s default, this field will reflect the amount as seen by the customer.
customer_facing_currencyFor transactions associated with charges, refunds, or disputes, the three-letter ISO currency code for customer_facing_amount.
customer_idThe unique ID of the related customer, if any.
customer_nameName of the customer, if any, associated with this balance transaction.
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
invoice_idUnique ID for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
is_linkWhether or not the payment was made using Link.
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payment_intent_idThe unique ID of the related Payment Intent, if any.
payment_method_typeThe type of payment method used in the related payment.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
shipping_address_cityCity of the shipping address associated with this charge, if any
shipping_address_countryCountry of the shipping address associated with this charge, if any
shipping_address_line1First line of the shipping address associated with this charge, if any
shipping_address_line2Second line of the shipping address associated with this charge, if any
shipping_address_postal_codePostal code of the shipping address associated with this charge, if any
shipping_address_stateState of the shipping address associated with this charge, if any
source_idThe Stripe object to which this transaction is related.
statement_descriptorThe dynamic statement descriptor or suffix specified when the related charge was created.
subscription_idUnique ID for the subscription associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing subscription.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.

Itemized balance change from activity

API report type: balance_change_from_activity.itemized.2

Column nameDefaultDescription
automatic_payout_effective_atThe date we expect this automatic payout to arrive in your bank account, in UTC. This is also when the paid-out funds are deducted from your Stripe balance.
automatic_payout_idID of the automatically created payout associated with this balance transaction (only set if your account is on an automatic payout schedule).
available_on_utcThe date the balance transaction’s net funds will become available in the Stripe balance. Dates in UTC.
balance_transaction_idUnique identifier for the balance transaction.
card_address_cityCity of the card address associated with this charge, if any
card_address_countryCountry of the card address associated with this charge, if any
card_address_line1First line of the card address associated with this charge, if any
card_address_line2Second line of the card address associated with this charge, if any
card_address_postal_codePostal code of the card address associated with this charge, if any
card_address_stateState of the card address associated with this charge, if any
card_brandCard brand, if applicable.
card_countryTwo-letter ISO code representing the country of the card.
card_fundingCard funding type, if applicable.
charge_created_utcCreation time of the original charge associated with this balance transaction. Available for charges, refunds and disputes. For charges that were separately authorized and captured, this is the authorization time. Dates in UTC.
charge_idUnique identifier for the original charge associated with this balance transaction. Available for charges, refunds and disputes.
connected_account_countryFor Stripe Connect activity related to a connected account, the two-letter ISO code representing the country of the account.
connected_account_direct_charge_id(Beta) For Stripe Connect activity related to a connected account, charge id of the direct charge that happened on connected account.
connected_account_idFor Stripe Connect activity related to a connected account, the unique ID for the account.
connected_account_nameFor Stripe Connect activity related to a connected account, the name of the account.
created_utcTime at which the balance transaction was created. Dates in UTC.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
customer_address_cityCity of the customer address associated with this charge, if any
customer_address_countryCountry of the customer address associated with this charge, if any
customer_address_line1First line of the customer address associated with this charge, if any
customer_address_line2Second line of the customer address associated with this charge, if any
customer_address_postal_codePostal code of the customer address associated with this charge, if any
customer_address_stateState of the customer address associated with this charge, if any
customer_descriptionDescription provided when creating the customer, often used to store the customer name.
customer_emailEmail address of the customer, if any, associated with this balance transaction.
customer_facing_amountFor transactions associated with charges, refunds, or disputes, the amount of the original charge, refund, or dispute. If the customer was charged in a different currency than your account’s default, this field will reflect the amount as seen by the customer.
customer_facing_currencyFor transactions associated with charges, refunds, or disputes, the three-letter ISO currency code for customer_facing_amount.
customer_idThe unique ID of the related customer, if any.
customer_nameName of the customer, if any, associated with this balance transaction.
customer_shipping_address_cityCity of the customer shipping address associated with this charge, if any
customer_shipping_address_countryCountry of the customer shipping address associated with this charge, if any
customer_shipping_address_line1First line of the customer shipping address associated with this charge, if any
customer_shipping_address_line2Second line of the customer shipping address associated with this charge, if any
customer_shipping_address_postal_codePostal code of the customer shipping address associated with this charge, if any
customer_shipping_address_stateState of the customer shipping address associated with this charge, if any
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
dispute_reasonReason given by cardholder for dispute. Read more about dispute reasons.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
invoice_idUnique ID for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
invoice_numberUnique Number for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
is_linkWhether or not the payment was made using Link.
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payment_intent_idThe unique ID of the related Payment Intent, if any.
payment_metadata[key]Metadata associated with the related PaymentIntent, if any. If no PaymentIntent metadata exists, metadata from any related charge object will be returned. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
payment_method_typeThe type of payment method used in the related payment.
refund_metadata[key]Metadata associated with the related refund object, if any. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
regulatory_tag​​An identifier reflecting the classification of this transaction according to local regulations, if applicable. Accounts with automatic payouts enabled receive a separate payout for each regulatory tag. ​​This column is only populated for Brazilian accounts.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
shipping_address_cityCity of the shipping address associated with this charge, if any
shipping_address_countryCountry of the shipping address associated with this charge, if any
shipping_address_line1First line of the shipping address associated with this charge, if any
shipping_address_line2Second line of the shipping address associated with this charge, if any
shipping_address_postal_codePostal code of the shipping address associated with this charge, if any
shipping_address_stateState of the shipping address associated with this charge, if any
source_idThe Stripe object to which this transaction is related.
statement_descriptorThe dynamic statement descriptor or suffix specified when the related charge was created.
subscription_idUnique ID for the subscription associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing subscription.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.
transfer_metadata[key]Metadata associated with the related transfer object, if any. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.

Itemized balance change from activity

API report type: balance_change_from_activity.itemized.3

Column nameDefaultDescription
application_feeApplication fee paid to your platform, only relevant for standard connected accounts.
automatic_payout_effective_atThe date we expect this automatic payout to arrive in your bank account, in the requested timezone, or UTC if not provided. This is also when the paid-out funds are deducted from your Stripe balance.
automatic_payout_effective_at_utcThe date we expect this automatic payout to arrive in your bank account, in UTC. This is also when the paid-out funds are deducted from your Stripe balance.
automatic_payout_idID of the automatically created payout associated with this balance transaction (only set if your account is on an automatic payout schedule).
available_onThe date the balance transaction’s net funds will become available in the Stripe balance. Dates in the requested timezone, or UTC if not provided.
available_on_utcThe date the balance transaction’s net funds will become available in the Stripe balance. Dates in UTC.
balance_transaction_idUnique identifier for the balance transaction.
card_address_cityCity of the card address associated with this charge, if any
card_address_countryCountry of the card address associated with this charge, if any
card_address_line1First line of the card address associated with this charge, if any
card_address_line2Second line of the card address associated with this charge, if any
card_address_postal_codePostal code of the card address associated with this charge, if any
card_address_stateState of the card address associated with this charge, if any
card_brandCard brand, if applicable.
card_countryTwo-letter ISO code representing the country of the card.
card_fundingCard funding type, if applicable.
charge_createdCreation time of the original charge associated with this balance transaction. Available for charges, refunds and disputes. For charges that were separately authorized and captured, this is the authorization time. Dates in the requested timezone, or UTC if not provided.
charge_created_utcCreation time of the original charge associated with this balance transaction. Available for charges, refunds and disputes. For charges that were separately authorized and captured, this is the authorization time. Dates in UTC.
charge_idUnique identifier for the original charge associated with this balance transaction. Available for charges, refunds and disputes.
connected_account_countryFor Stripe Connect activity related to a connected account, the two-letter ISO code representing the country of the account.
connected_account_direct_charge_id(Beta) For Stripe Connect activity related to a connected account, charge id of the direct charge that happened on connected account.
connected_account_idFor Stripe Connect activity related to a connected account, the unique ID for the account.
connected_account_nameFor Stripe Connect activity related to a connected account, the name of the account.
createdTime at which the balance transaction was created. Dates in the requested timezone, or UTC if not provided.
created_utcTime at which the balance transaction was created. Dates in UTC.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
customer_address_cityCity of the customer address associated with this charge, if any
customer_address_countryCountry of the customer address associated with this charge, if any
customer_address_line1First line of the customer address associated with this charge, if any
customer_address_line2Second line of the customer address associated with this charge, if any
customer_address_postal_codePostal code of the customer address associated with this charge, if any
customer_address_stateState of the customer address associated with this charge, if any
customer_descriptionDescription provided when creating the customer, often used to store the customer name.
customer_emailEmail address of the customer, if any, associated with this balance transaction.
customer_facing_amountFor transactions associated with charges, refunds, or disputes, the amount of the original charge, refund, or dispute. If the customer was charged in a different currency than your account’s default, this field will reflect the amount as seen by the customer.
customer_facing_currencyFor transactions associated with charges, refunds, or disputes, the three-letter ISO currency code for customer_facing_amount.
customer_idThe unique ID of the related customer, if any.
customer_nameName of the customer, if any, associated with this balance transaction.
customer_shipping_address_cityCity of the customer shipping address associated with this charge, if any
customer_shipping_address_countryCountry of the customer shipping address associated with this charge, if any
customer_shipping_address_line1First line of the customer shipping address associated with this charge, if any
customer_shipping_address_line2Second line of the customer shipping address associated with this charge, if any
customer_shipping_address_postal_codePostal code of the customer shipping address associated with this charge, if any
customer_shipping_address_stateState of the customer shipping address associated with this charge, if any
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
dispute_reasonReason given by cardholder for dispute. Read more about dispute reasons.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
invoice_idUnique ID for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
invoice_numberNumber for the invoice associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing invoice.
is_linkWhether or not the payment was made using Link.
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payment_intent_idThe unique ID of the related Payment Intent, if any.
payment_metadata[key]Metadata associated with the related PaymentIntent, if any. If no PaymentIntent metadata exists, metadata from any related charge object will be returned. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
payment_method_typeThe type of payment method used in the related payment.
refund_metadata[key]Metadata associated with the related refund object, if any. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.
regulatory_tag​​An identifier reflecting the classification of this transaction according to local regulations, if applicable. Accounts with automatic payouts enabled receive a separate payout for each regulatory tag. ​​This column is only populated for Brazilian accounts.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
shipping_address_cityCity of the shipping address associated with this charge, if any
shipping_address_countryCountry of the shipping address associated with this charge, if any
shipping_address_line1First line of the shipping address associated with this charge, if any
shipping_address_line2Second line of the shipping address associated with this charge, if any
shipping_address_postal_codePostal code of the shipping address associated with this charge, if any
shipping_address_stateState of the shipping address associated with this charge, if any
source_idThe Stripe object to which this transaction is related.
statement_descriptorThe dynamic statement descriptor or suffix specified when the related charge was created.
subscription_idUnique ID for the subscription associated with this balance transaction. Available for charges, refunds, and disputes made in connection with a Stripe Billing subscription.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.
transfer_metadata[key]Metadata associated with the related transfer object, if any. API requests including this column must specify a metadata key in brackets. This column can be specified multiple times to retrieve data from additional metadata keys.

Balance change from activity summary

API report type: balance_change_from_activity.summary.1

Column nameDefaultDescription
countThe number of transactions associated with the reporting_category.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
feeSum of the fees paid for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossSum of the gross amounts of the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netSum of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.

Itemized payouts

API report type: payouts.itemized.1

Column nameDefaultDescription
balance_transaction_idUnique identifier for the balance transaction.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
effective_at_utcFor automatic payouts, this is the date we expect funds to arrive in your bank account. For manual payouts, this is the date the payout was initiated. In both cases, it’s the date the paid-out funds are deducted from your Stripe balance. All dates in UTC.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payout_descriptionAn arbitrary string attached to the payout. Often useful for displaying to users.
payout_destination_idID of the bank account or card the payout was sent to.
payout_expected_arrival_dateDate the payout is scheduled to arrive in the bank. This factors in delays like weekends or bank holidays. Dates in UTC.
payout_idThe Stripe object to which this transaction is related.
payout_reversed_atTypically this field will be empty. However, if the payout’s status is canceled or failed, this field will reflect the time at which it entered that status.
payout_statusCurrent status of the payout ( paid, pending, in_transit, canceled or failed). A payout will be pending until it is submitted to the bank, at which point it becomes in_transit. It will then change to paid if the transaction goes through. If it does not go through successfully, its status will change to failed or canceled.
payout_typeCan be bank_account or card.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.

Itemized payouts

API report type: payouts.itemized.2

Column nameDefaultDescription
balance_transaction_idUnique identifier for the balance transaction.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
effective_at_utcFor automatic payouts, this is the date we expect funds to arrive in your bank account. For manual payouts, this is the date the payout was initiated. In both cases, it’s the date the paid-out funds are deducted from your Stripe balance. All dates in UTC.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payout_descriptionAn arbitrary string attached to the payout. Often useful for displaying to users.
payout_destination_idID of the bank account or card the payout was sent to.
payout_expected_arrival_dateDate the payout is scheduled to arrive in the bank. This factors in delays like weekends or bank holidays. Dates in UTC.
payout_idThe Stripe object to which this transaction is related.
payout_reversed_atTypically this field will be empty. However, if the payout’s status is canceled or failed, this field will reflect the time at which it entered that status.
payout_statusCurrent status of the payout ( paid, pending, in_transit, canceled or failed). A payout will be pending until it is submitted to the bank, at which point it becomes in_transit. It will then change to paid if the transaction goes through. If it does not go through successfully, its status will change to failed or canceled.
payout_typeCan be bank_account or card.
regulatory_tag​​An identifier reflecting the classification of this transaction according to local regulations, if applicable. Accounts with automatic payouts enabled receive a separate payout for each regulatory tag. ​​This column is only populated for Brazilian accounts.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.

Itemized payouts

API report type: payouts.itemized.3

Column nameDefaultDescription
application_feeApplication fees paid to your platform, only relevant for users on Standard connected accounts.
balance_transaction_idUnique identifier for the balance transaction.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
effective_atFor automatic payouts, this is the date we expect funds to arrive in your bank account. For manual payouts, this is the date the payout was initiated. In both cases, it’s the date the paid-out funds are deducted from your Stripe balance. All dates in the requested timezone, or UTC if not provided.
effective_at_utcFor automatic payouts, this is the date we expect funds to arrive in your bank account. For manual payouts, this is the date the payout was initiated. In both cases, it’s the date the paid-out funds are deducted from your Stripe balance. All dates in UTC.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payout_descriptionAn arbitrary string attached to the payout. Often useful for displaying to users.
payout_destination_idID of the bank account or card the payout was sent to.
payout_expected_arrival_dateDate the payout is scheduled to arrive in the bank. This factors in delays like weekends or bank holidays.
payout_idThe Stripe object to which this transaction is related.
payout_reversed_atTypically this field will be empty. However, if the payout’s status is canceled or failed, this field will reflect the time at which it entered that status. Times in the requested timezone, or UTC if not provided.
payout_reversed_at_utcTypically this field will be empty. However, if the payout’s status is canceled or failed, this field will reflect the time at which it entered that status. Times in UTC.
payout_statusCurrent status of the payout ( paid, pending, in_transit, canceled or failed). A payout will be pending until it is submitted to the bank, at which point it becomes in_transit. It will then change to paid if the transaction goes through. If it does not go through successfully, its status will change to failed or canceled.
payout_typeCan be bank_account or card.
regulatory_tag​​An identifier reflecting the classification of this transaction according to local regulations, if applicable. Accounts with automatic payouts enabled receive a separate payout for each regulatory tag. ​​This column is only populated for Brazilian accounts.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.

Payouts summary

API report type: payouts.summary.1

Column nameDefaultDescription
countThe number of transactions associated with the reporting_category.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
feeSum of the fees paid for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossSum of the gross amounts of the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netSum of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.

Balance summary

API report type: balance.summary.1

Column nameDefaultDescription
categoryOne of starting_balance, ending_balance, activity or payouts.
currencyThree-letter ISO code for the currency in which net_amount is defined.
descriptionOne of Starting balance (the related setting-MM-DD) - the balance at the start of the period, Activity - the net amount of all transactions that affected your balance except for payouts, Total payouts - the amount of payouts to your bank account, or Ending balance (the related setting-MM-DD) - the balance left over at the end of the period after subtracting payouts from the Starting balance and Activity.
net_amountNet amount for the transactions associated with category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).

Itemized payouts

API report type: payouts.itemized.4

Column nameDefaultDescription
balance_transaction_idUnique identifier for the balance transaction.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
effective_at_utcFor automatic payouts, this is the date we expect funds to arrive in your bank account. For manual payouts, this is the date the payout was initiated. In both cases, it’s the date the paid-out funds are deducted from your Stripe balance. All dates in UTC.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payout_descriptionAn arbitrary string attached to the payout. Often useful for displaying to users.
payout_destination_idID of the bank account or card the payout was sent to.
payout_expected_arrival_dateDate the payout is scheduled to arrive in the bank. This factors in delays like weekends or bank holidays. Dates in UTC.
payout_idThe Stripe object to which this transaction is related.
payout_reversed_atTypically this field will be empty. However, if the payout’s status is canceled or failed, this field will reflect the time at which it entered that status.
payout_statusCurrent status of the payout ( paid, pending, in_transit, canceled or failed). A payout will be pending until it is submitted to the bank, at which point it becomes in_transit. It will then change to paid if the transaction goes through. If it does not go through successfully, its status will change to failed or canceled.
payout_typeCan be bank_account or card.
regulatory_tag​​An identifier reflecting the classification of this transaction according to local regulations, if applicable. Accounts with automatic payouts enabled receive a separate payout for each regulatory tag. ​​This column is only populated for Brazilian accounts.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.

Itemized payouts

API report type: payouts.itemized.5

Column nameDefaultDescription
application_feeApplication fees paid to your platform, only relevant for users on Standard connected accounts.
balance_transaction_idUnique identifier for the balance transaction.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
descriptionAn arbitrary string attached to the balance transaction. Often useful for displaying to users.
effective_atFor automatic payouts, this is the date we expect funds to arrive in your bank account. For manual payouts, this is the date the payout was initiated. In both cases, it’s the date the paid-out funds are deducted from your Stripe balance. All dates in the requested timezone, or UTC if not provided.
effective_at_utcFor automatic payouts, this is the date we expect funds to arrive in your bank account. For manual payouts, this is the date the payout was initiated. In both cases, it’s the date the paid-out funds are deducted from your Stripe balance. All dates in UTC.
feeFees paid for this transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossGross amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netNet amount of the transaction. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
payout_descriptionAn arbitrary string attached to the payout. Often useful for displaying to users.
payout_destination_idID of the bank account or card the payout was sent to.
payout_expected_arrival_dateDate the payout is scheduled to arrive in the bank. This factors in delays like weekends or bank holidays.
payout_idThe Stripe object to which this transaction is related.
payout_reversed_atTypically this field will be empty. However, if the payout’s status is canceled or failed, this field will reflect the time at which it entered that status. Times in the requested timezone, or UTC if not provided.
payout_reversed_at_utcTypically this field will be empty. However, if the payout’s status is canceled or failed, this field will reflect the time at which it entered that status. Times in UTC.
payout_statusCurrent status of the payout ( paid, pending, in_transit, canceled or failed). A payout will be pending until it is submitted to the bank, at which point it becomes in_transit. It will then change to paid if the transaction goes through. If it does not go through successfully, its status will change to failed or canceled.
payout_typeCan be bank_account or card.
regulatory_tag​​An identifier reflecting the classification of this transaction according to local regulations, if applicable. Accounts with automatic payouts enabled receive a separate payout for each regulatory tag. ​​This column is only populated for Brazilian accounts.
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.
trace_idTrace ID is a unique identifier generated by bank for the Stripe payouts. Used by banks to locate specific transfers, sometimes referred to as a Reference number.
trace_id_statusThe status of the trace ID. Either pending, unsupported or supported.

Payouts summary

API report type: payouts.summary.2

Column nameDefaultDescription
countThe number of transactions associated with the reporting_category.
currencyThree-letter ISO code for the currency in which gross, fee and net are defined.
feeSum of the fees paid for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
grossSum of the gross amounts of the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
netSum of the net amounts for the transactions associated with the reporting_category. Expressed in major units of the currency (e.g. dollars for USD, yen for JPY).
reporting_categoryReporting Category is a new categorization of balance transactions, meant to improve on the current type field.

See also

Last verified 2026-09-24

Is this helpful?