The Core Balances API is in beta. Beta APIs can change without a version increment. Changes are announced in advance, and your Technical Account Manager works with you on them. See Versioning and backwards compatibility.
Which figure to use
spendableto decide whether a payment can go out. It is the figure Lead’s own authorization uses.cash_availablefor anything customer facing, such as a treasury dashboard, because it shows real cash without borrowed or swept funds.postedto reconcile against the Daily Balance report and against the sum of core transactions.
How core balances relate to the rest of the model
- Core account.
core_account_idnames the parent. A balance normally carries the same status as its account. See Core Balance Statuses. - Core transactions. Every core transaction names the
core_balance_idit affected. - Account numbers. On a
directaccount, account numbers attach to this balance, so an incoming payment to one of those numbers lands here.
What you can do
List and retrieve your core balances. Both operations are read only. Each request reads Lead’s core directly, so the figures reflect the ledger at the time of the request.What you cannot do
- Change a balance directly. Money moves only through payments and Lead’s own core activity.
- Subscribe to webhooks today. Poll the retrieve endpoint at the cadence your use case needs. See Banking Infrastructure for what is planned.

