balance_sheet

Read assets, liabilities and equity as of a date. Without one, includes all recorded postings, including future-dated ones. Amounts remain in the selected ledger currency.

What it shows

Assets, liabilities and equity with retained earnings, cumulative over postings up to as_of (default: every posting, future-dated ones included). The legal form in force at as_of names the equity section and its lines (stockholders’, members’, partners’ or owner’s equity). An account whose postings net to zero is left off.

Without a currency, when other currency ledgers hold postings, it adds other_currencies (each ledger’s own statement) and indicative: those converted into the functional currency at one rate per currency for the last day the report includes (the as_of date itself; today without as_of) and summed, never posted; the rates it used are listed, and a rate it lacks is named in missing_rates instead.

Example MCP App view

The read-only example below uses illustrative demo data and the same report component as the MCP App. These are not your books or the result of the request example.

Open the full example view.

Inputs

Send the fixed kind and these parameters at the top level of the report request, not inside input.

Required means required within its containing object; an optional parent can be omitted.

Reading the result

Running this report does not change the books. Its description above distinguishes recorded-book summaries from previews based on supplied facts or assumptions. Interpret its totals, grouping, missing-data indicators and pagination using that description. Monetary amounts are integer strings in the reported unit; ratios and assumptions can be fractional numbers. An empty result is not evidence that the business had no activity.

The public OpenAPI contract does not enumerate this report’s result fields. Fetch GET /v1/reports for its live description and parameters, and inspect the returned JSON rather than assuming an output shape.

Example request

{
  "kind": "balance_sheet"
}

All reports · Operation and errors · Reusable schemas

Keep credentials out of prompts; rehearse writes only in a disposable sandbox.

Exact request schema

{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "kind": {
      "const": "balance_sheet"
    },
    "currency": {
      "description": "Ledger currency (default: the functional currency active for the report period).",
      "type": "string",
      "minLength": 1
    },
    "as_of": {
      "description": "The date (YYYY-MM-DD) or UTC timestamp (RFC 3339) the report is taken at. A date is a UTC day and includes everything on it; a timestamp includes everything before that moment.",
      "type": "string",
      "minLength": 1
    }
  },
  "required": [
    "kind"
  ]
}