Balance sheet

​

The entity's balance sheet for each period column in the window. Sections are Assets, Liabilities and Equity; accounts nest under type groups and their parent accounts, each named by the same account_id the chart of accounts publishes. Balances on a balance sheet are cumulative as of each column's end date. start_date and end_date are inclusive; period_type (monthly, quarterly, yearly) chooses the columns, listed under periods and clipped to the window. Amounts are integer atoms of reporting_currency (cents for USD); a null cell means no data for that period rather than zero. The window may span at most 5 years. Built from the general ledger at request time, so every posted entry is reflected immediately.

Query Parameters

  • start_date
    Type: stringFormat: date
    required

    Inclusive start date for the report

  • end_date
    Type: stringFormat: date
    required

    Inclusive end date for the report

  • period_type
    Type: enum

    Time period grouping

Responses

  • application/json
  • 400

    The window spans more than 5 years (CAPI69).

  • 401

    Missing or invalid bearer API key (CAPI11).

  • 403

    The key lacks the customer_api:read permission (CAPI71).

  • application/json
Request Example for get/v1/reports/balance-sheet
curl 'https://api.t0.ai/v1/reports/balance-sheet?start_date=&end_date=&period_type=monthly' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "periods": [
    {
      "id": "string",
      "label": "string",
      "start_date": "2026-09-30",
      "end_date": "2026-09-30"
    }
  ],
  "sections": [
    {
      "account_type": "string",
      "label": "string",
      "balances": {
        "additionalProperty": 1
      },
      "children": [
        {
          "account_id": "string",
          "account_number": "string",
          "name": "string",
          "is_postable": true,
          "account_kind": "regular",
          "balances": {
            "additionalProperty": 1
          },
          "own_balances": {
            "additionalProperty": 1
          },
          "transaction_counts": {
            "additionalProperty": 1
          },
          "children": [
            {
              "account_id": "string",
              "account_number": "string",
              "name": "string",
              "is_postable": true,
              "account_kind": "regular",
              "balances": {
                "additionalProperty": 1
              },
              "own_balances": {
                "additionalProperty": 1
              },
              "transaction_counts": {
                "additionalProperty": 1
              },
              "children": []
            }
          ]
        }
      ]
    }
  ],
  "reporting_currency": "USD"
}

Successful Response