---
title: "Retrieves balance sheet report"
method: GET
path: "/reports/balance-sheet"
tags: ["Reports"]
---

# Retrieves balance sheet report

`GET /reports/balance-sheet`

Returns a balance sheet report as of the specified date.
Required parameter: as_of_date (ISO-8601 format YYYY-MM-DD). Must be provided or the call will fail.
Example: as_of_date=2024-12-31.

## Query parameters

- `as_of_date` string, date, required
- `subsidiary_id` string, uuid
- `breakdown_by` 'SUBSIDIARY' | 'CUSTOM_FIELD' — How to break down the report columns. If not specified, returns a single total column.

## Response `200`

OK

- BalanceSheetReport
  - `as_of_date` string, date, required — The date of the balance sheet
  - `currency` string, required — Currency code following ISO-4217
  - `breakdowns` ReportBreakdown[] — The breakdown columns for this report. When no breakdown_by is specified, this contains a single PERIOD entry representing the total.
    - `type` 'SUBSIDIARY' | 'CUSTOM_FIELD' | 'PERIOD', required — The type of breakdown
    - `name` string, required — Display name for this breakdown column
    - `id` string, uuid — The ID of the subsidiary or custom field value (if applicable)
  - `sections` NamedReportSection[], required — The sections of the balance sheet (e.g., Assets, Liabilities, Equity)
    - `name` string, required — The name of this section
    - `totals` BreakdownBalance[], required — Section totals, one per breakdown column.
      - `breakdown_id` string, uuid, required — The ID of the breakdown this balance belongs to
      - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
        - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
        - `currency` string, required — Currency code following ISO-4217
    - `groups` ReportAccountGroup[], required
      - `name` string, required
      - `totals` BreakdownBalance[], required — Group totals, one per breakdown column.
        - `breakdown_id` string, uuid, required — The ID of the breakdown this balance belongs to
        - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
          - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
          - `currency` string, required — Currency code following ISO-4217
      - `accounts` ReportAccountEntry[], required
        - `id` string, uuid, required
        - `code` string, required
        - `name` string, required
        - `balances` BreakdownBalance[], required — Account balances, one per breakdown column.
          - `breakdown_id` string, uuid, required — The ID of the breakdown this balance belongs to
          - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
            - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
            - `currency` string, required — Currency code following ISO-4217
      - `groups` ReportAccountGroupNested[]
        - `name` string, required
        - `totals` BreakdownBalance[], required — Group totals, one per breakdown column.
          - `breakdown_id` string, uuid, required — The ID of the breakdown this balance belongs to
          - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
            - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
            - `currency` string, required — Currency code following ISO-4217
        - `accounts` ReportAccountEntry[], required — All accounts in this group, including accounts of more deeply nested account groups, sorted by account code.
          - `id` string, uuid, required
          - `code` string, required
          - `name` string, required
          - `balances` BreakdownBalance[], required — Account balances, one per breakdown column.
            - `breakdown_id` string, uuid, required — The ID of the breakdown this balance belongs to
            - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
              - …
    - `accounts` ReportAccountEntry[]
      - `id` string, uuid, required
      - `code` string, required
      - `name` string, required
      - `balances` BreakdownBalance[], required — Account balances, one per breakdown column.
        - `breakdown_id` string, uuid, required — The ID of the breakdown this balance belongs to
        - `amount` RoundedMonetaryAmount, required — A monetary amount that must be rounded to the currency's default decimal places (e.g., 2 decimal places for USD).
          - `amount` string, required — Monetary amount in decimal format, using a period (.) as the decimal separator. Must be rounded to the currency's default decimal places (e.g. '1.01' in USD represents 1 dollar and 1 cent).
          - `currency` string, required — Currency code following ISO-4217

## Other responses

- `default` — Error

---

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