Light APIv1.0.0

API / Reference / Bank Accounts

Get bank account balance

GET https://api.light.inc/v1/bank-accounts/{bankAccountId}/balance

Returns the bank statement balance and ledger balance for a bank account as of the given date. If asOf is omitted, today's balance is returned. The bank balance is derived from the opening balance plus all bank transactions on or before asOf; the ledger balance is the sum of ledger transaction lines posted on or before asOf for the linked ledger account.

Authorization

Send one of these on every request. See Authentication for how to get credentials.

  • API key

    Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.

  • Bearer token

Path parameters

  • bankAccountId string · uuidrequired

Query parameters

  • asOf string

    Date the balance is computed for (ISO-8601, e.g. 2026-05-07). Defaults to today.

Response

  • bankAccountId string · uuid

    ID of the bank account

  • currency string

    Currency of the bank account (ISO 4217)

  • bankBalance integer · int64

    Bank statement balance in minor units (e.g. cents). Computed from the opening balance plus all bank transactions on or before asOf. Null if no opening balance has been set for this bank account.

  • ledgerBalance integer · int64

    Ledger balance in minor units (e.g. cents). Computed from all ledger transaction lines posted on or before asOf for the bank account's ledger account.

  • asOf string · date

    Date the balance is computed for