ItemizedBalanceChangeFromActivityReport
Returns the itemized balance change from activity report, including transaction amounts, fees, customer, charge, and payout details.
View-Specific Information
Note: This report requires a live-mode API key, which can be set using the LiveAPIKey connection property. This view is not accessible without specifying the LiveAPIKey.
Creating the Report
To create a report, the following columns are required:
- ParametersIntervalStart
- ParametersIntervalEnd
You can also include the following optional columns:
- ParametersColumns
- ParametersCurrency
- ParametersTimezone
- ParametersReportingCategory
// This first creates the new report and displays it. Report creation may take time before results are displayed.
SELECT * FROM ItemizedBalanceChangeFromActivityReport WHERE ParametersIntervalStart = '2020-12-27' AND ParametersIntervalEnd = '2020-12-28'
SELECT
You can run the following queries to retrieve report data:
SELECT * FROM ItemizedBalanceChangeFromActivityReport WHERE Id IN (SELECT Id FROM Reports WHERE report_type = 'balance_change_from_activity.itemized.3')
SELECT * FROM ItemizedBalanceChangeFromActivityReport WHERE Id IN ('frr_1I54dkATXQzBWNrlnaavpHGe', 'frr_1I3I59ATXQzBWNrl9VcczrDY') // This will show multiple reports
SELECT * FROM ItemizedBalanceChangeFromActivityReport WHERE Id = 'frr_1I480mATXQzBWNrlYQRaLQ9x' // This will show a respective report
Columns
| Name | Type | References | Description |
| Automatic_Payout_Id | String | The Id of the automatically created payout associated with this balance transaction. This is only set if your account is on an automatic payout schedule. | |
| Automatic_Payout_Effective_At | Datetime | The date on which this automatic payout is expected 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. | |
| Balance_Transaction_Id | String | The unique identifier for the balance transaction. | |
| Created_UTC | Datetime | The time at which the balance transaction was created, with dates in UTC. | |
| Created | Datetime | The time at which the balance transaction was created, with dates in the requested timezone, or UTC if not provided. | |
| Available_On_UTC | Datetime | The date on which the balance transaction's net funds become available in the Stripe balance, with dates in UTC. | |
| Available_On | Datetime | The date on which the balance transaction's net funds become available in the Stripe balance, with dates in the requested timezone, or UTC if not provided. | |
| Currency | String | The three-letter ISO code for the currency in which the gross, fee, and net amounts are defined. | |
| Gross | Decimal | The gross amount of the transaction, expressed in major units of the currency, such as dollars for USD or yen for JPY. | |
| Fee | Decimal | The fees paid for this transaction, expressed in major units of the currency, such as dollars for USD or yen for JPY. | |
| Net | Decimal | The net amount of the transaction, expressed in major units of the currency, such as dollars for USD or yen for JPY. | |
| Reporting_Category | String | The reporting category of the balance transaction, a categorization that improves on the current type field. | |
| Source_Id | String | The Stripe object to which this transaction is related. | |
| Description | String | An arbitrary string attached to the balance transaction, often useful for displaying to users. | |
| Customer_Facing_Amount | Decimal | The amount of the original charge or refund, for transactions associated with charges or refunds. | |
| Customer_Facing_Currency | String | The three-letter ISO code for the currency of customer_facing_amount, for transactions associated with charges or refunds. | |
| Automatic_Payout_Effective_At_UTC | Datetime | The date on which this automatic payout is expected to arrive in your bank account, in UTC. This is also when the paid-out funds are deducted from your Stripe balance. | |
| Customer_Id | String | The unique Id of the related customer, if any. | |
| Customer_Email | String | The email address of the customer, if any, associated with this balance transaction. | |
| Customer_Name | String | The name of the customer, if any, associated with this balance transaction. | |
| Customer_Description | String | The description provided when creating the customer, often used to store the customer name. | |
| Shipping_Address_Line1 | String | The first line of the shipping address associated with this charge, if any. | |
| Shipping_Address_Line2 | String | The second line of the shipping address associated with this charge, if any. | |
| Shipping_Address_City | String | The city of the shipping address associated with this charge, if any. | |
| Shipping_Address_State | String | The state of the shipping address associated with this charge, if any. | |
| Shipping_Address_Postal_Code | String | The postal code of the shipping address associated with this charge, if any. | |
| Shipping_Address_Country | String | The country of the shipping address associated with this charge, if any. | |
| Charge_Id | String | The unique identifier for the original charge associated with this balance transaction. This is available for charges, refunds, and disputes. | |
| Payment_Intent_Id | String | The unique Id of the related payment intent, if any. | |
| Charge_Created_UTC | Datetime | The creation time of the original charge associated with this balance transaction, with dates in UTC. This is available for charges, refunds, and disputes. For charges that were separately authorized and captured, this is the authorization time. | |
| Charge_Created | Datetime | The creation time of the original charge associated with this balance transaction, with dates in the requested timezone, or UTC if not provided. This is available for charges, refunds, and disputes. For charges that were separately authorized and captured, this is the authorization time. | |
| Invoice_Id | String | The unique Id for the invoice associated with this balance transaction. This is available for charges, refunds, and disputes made in connection with a Stripe Billing invoice. | |
| Subscription_Id | String | The unique Id for the subscription associated with this balance transaction. This is available for charges, refunds, and disputes made in connection with a Stripe Billing subscription. | |
| Payment_Method_Type | String | The type of payment method used in the related payment. | |
| Card_Brand | String | The card brand, if applicable. | |
| Card_Funding | String | The card funding type, if applicable. | |
| Card_Country | String | The two-letter ISO code representing the country of the card. | |
| Statement_Descriptor | String | The dynamic statement descriptor or suffix specified when the related charge was created. | |
| Dispute_Reason | String | The reason given by the cardholder for the dispute. | |
| Connected_Account_Id | String | The unique Id for the connected account, for Stripe Connect activity related to a connected account. | |
| Connected_Account_Name | String | The name of the connected account, for Stripe Connect activity related to a connected account. | |
| Connected_Account_Country | String | The two-letter ISO code representing the country of the connected account, for Stripe Connect activity related to a connected account. | |
| Regulatory_Tag | String | The 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. | |
| Payment_Metadata | String | The metadata associated with the related payment intent, if any. If no payment intent metadata exists, metadata from any related charge object is 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. | |
| Refund_Metadata | String | The 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. | |
| Transfer_Metadata | String | The 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. | |
| Id | String |
Reports.Id | The unique identifier for the report run object. |
| ParametersIntervalEnd | Datetime | The ending timestamp of the data to include in the report run, exclusive. | |
| ParametersIntervalStart | Datetime | The starting timestamp of the data to include in the report run. | |
| ParametersColumns | String | The set of output columns requested for inclusion in the report run. | |
| ParametersCurrency | String | The currency of the objects to include in the report run. | |
| ParametersReportingCategory | String | The category of balance transactions to include in the report run. | |
| ParametersTimezone | String | The output timezone for all timestamps in the report. Defaults to Etc/UTC. |