Sent when an account’s settled balance changes. Carries the full account object — the same shape as ACCOUNT_STATUS_UPDATE, with the updated balances.settled. All deliveries share the common envelope (eventId, eventName, timestamp, programId, sandbox, customerId, clientReference).

​
account fields

The currency determines the rail identifiers: EUR carries iban/bic, GBP carries accountNumber/sortCode, and MULTI carries neither.
FieldTypeNotes
accountIdstringThe account identifier.
currencystringEUR, GBP, or MULTI.
iban / bicstringEUR accounts only.
accountNumber / sortCodestringGBP accounts only.
statusstringPENDING, ACTIVE, BLOCKED, or CLOSED.
balances.settlednumberUpdated settled balance, minor units.

​
Example

{
  "eventId": "a7e4…",
  "eventName": "ACCOUNT_BALANCE_UPDATE",
  "timestamp": "2026-06-23T12:34:56.789Z",
  "programId": "yourprogram",
  "sandbox": false,
  "customerId": "cust_123",
  "account": {
    "accountId": "acc_456",
    "currency": "EUR",
    "iban": "NL31CLRB0024757476",
    "bic": "CLRBNL2A029",
    "status": "ACTIVE",
    "balances": { "settled": 10000 }
  }
}