Ledga
GET /account-sets/{accountSetId}/balance

Get aggregated balance for all accounts in this set

Get aggregated balance for the account set

Parameters

NameInTypeDescription
accountSetIdrequired path string
uuid
Account Set UUID
layer query string
enum: settled | pending | encumbrance · default: "settled"
The layer to sum (case-insensitive). Default settled.
as_of_date query string
date
Sum each member's layer balance over the entries effective by the end of this date (Y-m-d, in the ledger's timezone), past, today or future. Omit it for the current balance: every posting committed by the moment of the request, whatever its effective date.

Responses

200Balance retrieved
{
  "success": true,
  "data": {
    "account_set_id": "01997c1e-4d2a-7c3e-9a1b-2f0e8c6d4b5a",
    "account_set_code": "string",
    "account_set_name": "string",
    "total_balance": "1000.00",
    "layer": "settled",
    "as_of_date": "2026-09-30",
    "currency": "USD",
    "account_count": 0
  }
}
401Unauthenticated
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}
403Forbidden
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}
404Account set not found
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}
422Invalid layer or as_of_date, or a set of more than 500 accounts (ACCOUNT_SET_TOO_LARGE)
{
  "success": false,
  "message": "Validation failed",
  "code": "VALIDATION_ERROR"
}

Examples

curl https://ledga.io/api/v1/account-sets/{accountSetId}/balance \
  -H "Authorization: Bearer sk_xxxxxxxx_your_secret"

← All endpoints