parallel45 API error
insufficient_funds
Insufficient funds
Published ahead of the API. No endpoint emits this code yet — error
exits currently carry type: "about:blank". Read this as the intended contract,
not as a description of live behaviour. About this catalogue
- Problem
type - https://errors.parallel45.tech/insufficient_funds
- HTTP status
- 402 or 409
- Retryable
- No — the identical request will fail identically.
What it means
The account does not hold enough settled, available cash for this instruction.
Only the available balance can be spent. Cash that is reserved against in-flight settlement, or unsettled and still clearing, is not spendable and is deliberately reported as a separate bucket rather than folded into one total.
What to do
Show the shortfall against the available balance. Retrying the same amount will fail until the balance changes; a smaller amount may succeed immediately.
Do not confuse this with
A generic 4xx. This is the only 402 the API emits, on both cash withdrawal and goal top-up -- a client that branches on status alone will mistake it for something else.