---
title: "Get the balance of accounts"
method: POST
path: "/consumers/{consumer_id}/accounting/chart-of-accounts/balance"
tags: ["Accounting", "Ledger accounts"]
---

# Get the balance of accounts

`POST /consumers/{consumer_id}/accounting/chart-of-accounts/balance`

Get the balance of accounts in the accounting plan (chart of accounts) between specific months

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `page` integer
- `size` integer
- `folder_id` string, nullable

## Request body

- AccountBalanceFilter
  - `accounts` string[], required — Array/list containing the account numbers/classes to include in the response. E.g. ["601", "7"] to retrieve all account in the class 7 and accounts with an account number beginning with 601
  - `start` string, nullable — Start month (inclusive). Format: YYYYMM (e.g., 202502 for February 2025).
  - `end` string, required — End month (inclusive). Format: YYYYMM (e.g., 202512 for December 2025).

## Response `200`

Successful Response

- ChiftPageAccountBalance
  - `items` AccountBalance[], required
    - `account_number` string, required — Ledger account number in the chart of accounts
    - `account_name` string, nullable — Display name of the ledger account
    - `debit` number, required — Debit at end date. When debit and credit are equal to 0 and balance is different from 0 then the debit and credit cannot be determined, only the balance can be calculated in those cases.
    - `credit` number, required — Credit at end date. When debit and credit are equal to 0 and balance is different from 0 then the debit and credit cannot be determined, only the balance can be calculated in those cases.
    - `balance` number, required
    - `period_debit` number, required — Debit at end date beginning from the given start date. When debit and credit are equal to 0 and balance is different from 0 then the debit and credit cannot be determined, only the balance can be calculated in those cases.
    - `period_credit` number, required — Credit at end date beginning from the given start date. When debit and credit are equal to 0 and balance is different from 0 then the debit and credit cannot be determined, only the balance can be calculated in those cases.
    - `period_balance` number, required — Balance at end date beginning from the given start date.
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

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