---
title: "Get Financial Report"
method: GET
path: "/financial_reports"
tags: ["Ledgers"]
---

# Get Financial Report

`GET /financial_reports`

Returns a financial report — balance activity, income statement, or balance summary — for an account over a date range.

## Query parameters

- `account_id` string, required
- `report_type` 'balance_summary' | 'income_statement' | 'balance_activity', required
- `currency` string
- `in_currency` string
- `from_date` string
- `to_date` string
- `group_by` 'day' | 'week' | 'month'
- `timezone` string
- `cumulative` boolean
- `scope_account_id` string

## Response `200`

financial report returned

- object
  - `beginning_balance` number, nullable
  - `ending_balance` number, nullable
  - `fx_excluded_currencies` string[]
  - `report_type` 'balance_summary' | 'income_statement' | 'balance_activity', required — The report that was generated, echoing the requested `report_type`.
  - `rows` object[], required
    - `account_ik_path` string, nullable
    - `account_name` string, nullable
    - `account_type` string, nullable
    - `amount` number, required
    - `grouping` 'advertising' | 'affiliates_and_revshare' | 'airdrops' | 'bad_debt' | 'balance' | 'clawbacks' | 'connected_accounts' | 'crypto' | 'disputes' | 'fees' | 'fx' | 'legacy' | 'misc' | 'other' | 'payments' | 'refunds' | 'reserves' | 'transfers' | 'wallets_and_balance' | 'withdrawals', required — The family the row's `line_category` rolls up into. Balance summary rows are always `balance`.
    - `line_category` 'account_settlement' | 'ad_balance_funding_receipt' | 'ad_budget_release' | 'ad_campaign_budget' | 'ad_funding_disbursement' | 'ad_income_expense' | 'ad_income_receipt' | 'ad_network_cost' | 'ad_network_settlement' | 'ad_publisher_payout' | 'ad_publisher_payout_received' | 'ad_spend_charge' | 'ad_spend_margin' | 'ads_card_spread' | 'affiliate_fee' | 'aggregated_fee' | 'airdrop' | 'airdrop_expense' | 'airdrop_expense_reversal' | 'airdrop_link_canceled' | 'airdrop_link_claimed' | 'airdrop_link_created' | 'airdrop_link_funded' | 'airdrop_link_redeemed' | 'airdrop_link_returned' | 'airdrop_reversal' | 'application_fee' | 'application_fee_payable' | 'application_fee_payout' | 'available' | 'bad_debt_expense' | 'bad_debt_offset' | 'balance_reservation' | 'balance_reservation_hold' | 'balance_reservation_release' | 'balance_reservation_reversal' | 'billing_percentage_fee' | 'buyer_fee' | 'card_interchange' | 'card_interchange_receivable' | 'card_load_deposit' | 'card_load_transfer' | 'card_spend_authorization' | 'card_spend_authorization_hold' | 'card_spend_authorization_void' | 'card_spend_authorization_void_release' | 'card_spend_capture' | 'card_spend_capture_offset' | 'card_spend_refund' | 'card_spend_refund_offset' | 'card_unload_deposit' | 'card_unload_transfer' | 'clawback_fee' | 'clawback_receivable' | 'clawback_receivable_reversal' | 'clawback_receivable_settlement' | 'clawback_receivable_settlement_reversal' | 'company_referral' | 'connected_account_clawback' | 'connected_account_negative_balance' | 'cross_border_percentage_fee' | 'crypto' | 'currency_conversion_incoming' | 'currency_conversion_outgoing' | 'dispute_alert_fee' | 'dispute_hold' | 'dispute_hold_adjustment' | 'dispute_hold_blocked' | 'dispute_management_fee' | 'dispute_payable_clearing' | 'dispute_payable_reversal' | 'dispute_settlement' | 'dispute_settlement_reversal' | 'dispute_unreconciled_clearing' | 'dispute_unreconciled_reversal' | 'external_account_connection_fee' | 'external_card_load_deposit' | 'external_card_load_offset' | 'fraud_prevention_fee' | 'fx_gain_loss' | 'fx_markup' | 'fx_percentage_fee' | 'fx_settlement_gain_loss' | 'high_risk_merchant_fee' | 'identity_verification_fee' | 'installment_default' | 'internal_balance_transfer_incoming' | 'internal_balance_transfer_outgoing' | 'legacy_crypto_payment' | 'legacy_payment' | 'legacy_payment_refund' | 'license_sale' | 'license_sale_commission' | 'license_sale_revenue' | 'marketplace_affiliate_fee' | 'misc_purchase' | 'misc_refund' | 'misc_reversal' | 'onchain_deposit' | 'onchain_deposit_offset' | 'onchain_swap_offset' | 'onchain_swap_source' | 'onchain_swap_target' | 'onchain_wallet_transfer_incoming' | 'onchain_wallet_transfer_outgoing' | 'onchain_withdrawal' | 'onchain_withdrawal_offset' | 'orchestration_percentage_fee' | 'passthrough_gmv' | 'passthrough_gmv_offset' | 'payment_dispute' | 'payment_dispute_adjustment' | 'payment_dispute_fee' | 'payment_dispute_reversal' | 'payment_gross' | 'payment_gross_reversal' | 'payment_processing_fixed_fee' | 'payment_processing_percentage_fee' | 'payment_receivable_clearing' | 'payment_receivable_reversal' | 'payment_receivable_settlement' | 'payment_referral' | 'payment_referral_payable' | 'payment_referral_refund' | 'payment_referral_reversal' | 'payment_refund' | 'payment_refund_fee' | 'payment_refund_reversal' | 'payment_revshare' | 'payment_revshare_payout' | 'payment_revshare_refund' | 'payment_revshare_reversal' | 'payment_unreconciled_clearing' | 'payment_unreconciled_reversal' | 'payout_fee' | 'payout_receivable' | 'payout_subsidy' | 'payout_unreconciled_clearing' | 'pending' | 'platform_affiliate_payment' | 'platform_affiliate_payment_reversal' | 'platform_balance_payment' | 'platform_balance_payment_refund' | 'platform_balance_transfer_fee' | 'platform_balance_transfer_incoming' | 'platform_balance_transfer_outgoing' | 'platform_covered_dispute' | 'platform_earning' | 'platform_earning_settlement' | 'platform_earning_unreconciled_clearing' | 'promo_reversal' | 'psp_account_updater_fee' | 'psp_adjusted_processing_fee' | 'psp_authentication_fee' | 'psp_billing_fee' | 'psp_clawback_fee' | 'psp_clawback_settlement' | 'psp_clawback_settlement_reversal' | 'psp_commission_fee' | 'psp_connect_fee' | 'psp_correction' | 'psp_dispute_alert_fee' | 'psp_dispute_fee' | 'psp_dispute_management_fee' | 'psp_dispute_payable' | 'psp_external_account_connection_fee' | 'psp_fixed_fee' | 'psp_gateway_fee' | 'psp_identity_verification_fee' | 'psp_interchange_fee' | 'psp_invoice_tax_fee' | 'psp_invoicing_fee' | 'psp_markup_fee' | 'psp_network_token_fee' | 'psp_optimization_fee' | 'psp_payin_clearing' | 'psp_payin_settlement' | 'psp_payment_method_fee' | 'psp_payment_receivable' | 'psp_payout_consolidation' | 'psp_payout_deposit' | 'psp_payout_fee' | 'psp_payout_receivable' | 'psp_payout_receivable_clearing' | 'psp_payout_settlement' | 'psp_payout_settlement_reversal' | 'psp_pool_clearing' | 'psp_pool_dispute_settlement' | 'psp_pool_settlement' | 'psp_processing_fee' | 'psp_receivable_pooled' | 'psp_recipient_wallet_load' | 'psp_refund_fee' | 'psp_refund_payable' | 'psp_reserve_hold' | 'psp_reserve_release' | 'psp_risk_fee' | 'psp_scheme_fee' | 'psp_service_fee' | 'psp_tax_filing_fee' | 'psp_tax_service_fee' | 'psp_terminal_fee' | 'psp_transfer_settlement' | 'psp_transfer_settlement_reversal' | 'psp_treasury_fee' | 'psp_variable_fee' | 'psp_withholding_tax' | 'recipient_wallet_load' | 'referral_bonus' | 'refund_payable_clearing' | 'refund_payable_reversal' | 'refund_settlement' | 'refund_settlement_reversal' | 'refund_unreconciled_clearing' | 'refund_unreconciled_reversal' | 'reserve' | 'resolution_center_refund' | 'revshare_percentage_fee' | 'sales_tax_collected' | 'sales_tax_collected_reversal' | 'sales_tax_fee' | 'sales_tax_remittance' | 'sales_tax_remittance_reversal' | 'settlement_rounding_variance' | 'software_rental_revshare' | 'software_rental_transaction' | 'stripe_domestic_processing_fee' | 'stripe_international_processing_fee' | 'swap_fee' | 'tax_filing_fee' | 'three_ds_fixed_fee' | 'topup' | 'topup_fee' | 'topup_reversal' | 'treasury_fee' | 'treasury_payin' | 'treasury_payin_receivable' | 'whop_processing_fee' | 'whop_swap_fee_received' | 'withdrawal' | 'withdrawal_clawback' | 'withdrawal_clawback_reversal' | 'withdrawal_fee' | 'withdrawal_fee_reversal' | 'withdrawal_markup_fee' | 'withdrawal_markup_fee_payout' | 'withdrawal_markup_fee_payout_reversal' | 'withdrawal_markup_fee_reversal' | 'withdrawal_payable' | 'withdrawal_payable_clearing' | 'withdrawal_payable_clearing_reversal' | 'withdrawal_payable_reversal' | 'withdrawal_reclassification' | 'withdrawal_reversal' | 'withdrawal_topup_adjustment', required — The ledger line category the row aggregates. Balance summary rows carry the balance bucket instead.
    - `line_count` integer, nullable
    - `period` string, required — Start of the time bucket this row covers, truncated to `group_by`.
    - `profit_and_loss_section` 'revenue' | 'cost_of_revenue' | 'null', nullable — Which side of the income statement the category falls on, or `null` when it is not a P&L category.
  - `total` number, required

## Other responses

- `400` — Invalid Parameters
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Resource not found

---

[API](https://skmtc.net/whop/apis/whop-api.md) · [All operations](https://skmtc.net/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/whop/whop-api/versions/db0883548bc5/schema)
