Skip to main content
Lead manages every core balance status. You never call an endpoint to change one. A core balance shares its lifecycle with the core account it belongs to, and the two normally change together. Core Account Statuses describes that lifecycle in full; this page covers what is specific to the balance.

​
Lifecycle

​
Statuses

​
What an inactive balance means for account numbers

Account numbers keep their own status, so an account number can show active and still not transact while its account is inactive. If payments fail unexpectedly, check the core account and core balance status first. If the balance and its account disagree, treat the balance as authoritative for whether money can move, and contact your Technical Account Manager.

​
Observing changes

Core balances do not emit events today, for status changes or for amount changes. Poll GET /v2/core_balances/{id} at the cadence your use case needs. The Core Balance Object · Core Account Statuses · Account Number Statuses