---
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 the given ledger account over the requested date range, or a platform-wide report when account_id is `global` (internal admin access only). Dates are ISO 8601 timestamps (UTC). Use `in_currency` with `currency` to aggregate multi-currency activity into a single display currency via FX conversion.

## Query parameters

- `account_id` string, required
- `report_type` 'balance_activity' | 'income_statement' | 'balance_summary', 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` string, required
  - `rows` object[], required
    - `account_ik_path` string, nullable
    - `account_name` string, nullable
    - `account_type` string, nullable
    - `amount` number, required
    - `grouping` string, required
    - `line_category` string, required
    - `line_count` integer, nullable
    - `period` string, required
    - `profit_and_loss_section` 'revenue' | 'cost_of_revenue' | 'null', nullable
  - `total` number, required

## Other responses

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

## Changes

- **2026-07-26** `60bbb4a6ffbc` — 2 info
  - for the `query` request parameter `from_date`, the type was generalized from `integer` to `string`
  - for the `query` request parameter `to_date`, the type was generalized from `integer` to `string`

[Change history](https://skmtc.dev/whop/apis/whop-api/changes/financial_reports/get.md)

---

[API](https://skmtc.dev/whop/apis/whop-api.md) · [All operations](https://skmtc.dev/whop/apis/whop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/whop/whop-api/revisions/60bbb4a6ffbc/schema)