Balance Statuses

Balance statuses describe your report of a balance’s state — you are the ledger of record, you determine when a balance’s status changes, and you communicate it through your daily Balance file reporting. Every balance carries a status and a status_reason, which pair together to define its state.

The Statuses

Status	Meaning	`status_reason` values
`active`	Fully functional and operating as expected. Default on creation — via the Subledger Balance API for credit balances, or via the daily Balance file for deposit balances.	`active`
`inactive`	You have taken action to restrict activity on the balance. Lead runs no additional validations on inactive balances during daily reporting — you are expected to take action on them according to your own policies.	`dormant` · `frozen` · `other`
`closed`	Terminal. The balance is no longer active.	`entity_closed` · `client_closed` · `paid_off` · `charged_off` · `canceled`
`receivable_transferred`	Terminal — credit balances only. Any outstanding receivable(s) on the balance has been transferred from Lead to you (balance-sheet models). Reachable from `active` or `inactive`. After setting this status, omit the balance from all subsequent Balance files. Use is limited to specific use cases — ask your Technical Account Manager whether it applies to your program.	`receivable_sold_to_partner`

Reporting the Lifecycle

Active and inactive balances appear in every day’s file until you transition them to a terminal status — a balance missing from a day’s file without a terminal transition is a validation failure, not an implicit closure (troubleshooting). The one exception is receivable_transferred, which is omitted from all files after the transition is reported.
Terminal transitions are guarded: a balance cannot be reported into closed or receivable_transferred while any Funding against it is still processing — the file fails with balance_cannot_be_terminal_with_processing_funding. Wait for the Funding to reach posted or rejected, then report the transition.
Creation is guarded from October 6, 2026: every new balance must reference a valid parent Account (Upcoming Changes)

Banking Infrastructure

Lending & Receivables

Payment Rails

Customers & Accounts

Network Settlement

The Statuses

Reporting the Lifecycle

​The Statuses

​Reporting the Lifecycle

The Statuses

Reporting the Lifecycle