Sign in
Ledgers

Get Financial Report Breakdown

Returns the top entities behind one high-level financial report bucket and an aggregate remainder.

get/financial_reports/breakdown

Query parameters

account_idstring required

The owning account ID (a biz_ identifier).

bucket'transfers' | 'payments' | 'refunds' | 'ads' | 'application_fees' | 'card_spend' | 'card_authorization_releases' | 'withdrawals' | 'withdrawal_markup' | 'platform_markup' | 'clawbacks' | 'disputes' | 'affiliate_earnings' | 'affiliate_payouts' | 'revenue_share' | 'swaps' | 'card_loads' required

The high-level report bucket to explain.

direction'money_in' | 'money_out' required

Whether to explain money received or money sent.

currencystring required

The report currency to explain.

fromstring date-time required

Start of the report window as an ISO 8601 timestamp.

tostring date-time required

Exclusive end of the report window as an ISO 8601 timestamp.

group_by'day' | 'week' | 'month'

Period grouping used by the parent report.

timezonestring

IANA timezone used by the parent report to bucket periods. Defaults to UTC.

Headers

Api-Version-Datestring
Example:2026-09-15

Pins the request to a dated API version.

Response

breakdown returned

bucket'transfers' | 'payments' | 'refunds' | 'ads' | 'application_fees' | 'card_spend' | 'card_authorization_releases' | 'withdrawals' | 'withdrawal_markup' | 'platform_markup' | 'clawbacks' | 'disputes' | 'affiliate_earnings' | 'affiliate_payouts' | 'revenue_share' | 'swaps' | 'card_loads' required
currencystring required
direction'money_in' | 'money_out' required
other_namestring required

Example response

{
  "activity_filters": {
    "direction": "money_out",
    "line_types": [
      "platform_balance_transfer_outgoing"
    ]
  },
  "bucket": "transfers",
  "currency": "usd",
  "direction": "money_out",
  "items": [
    {
      "amount": {
        "amount": "-2.50",
        "currency": "usd",
        "decimals": 2,
        "display_decimals": 2
      },
      "avatar": {
        "shape": "circle"
      },
      "object": "user"
    }
  ],
  "other_amount": {
    "amount": "-2.50",
    "currency": "usd",
    "decimals": 2,
    "display_decimals": 2
  },
  "other_name": "Other"
}

Changes