Account balance changed

{ "id": "evt_019cbf61a2557aada6e82020cbe5021f", "type": "account.balance.changed", "createdAt": "2026-11-12T10:30:00Z", "data": { "accountId": "019cbf58-1b2a-7c3d-9e4f-5a6b7c8d9e0f", "balances": [ { "currency": "EUR", "decimals": 18, "spendable": "125000000000000000000", "nonSpendable": "0", "processingDeposits": "0", "processingWithdrawals": "0" }, { "currency": "GBP", "decimals": 18, "spendable": "0", "nonSpendable": "0", "processingDeposits": "0", "processingWithdrawals": "0" }, { "currency": "USD", "decimals": 6, "spendable": "0", "nonSpendable": "0", "processingDeposits": "0", "processingWithdrawals": "0" } ], "reason": "deposit", "referenceId": "019cbf59-0e4d-75ab-a1ce-d6f75f27dd73" } }

Headers

X-Webhook-Timestamp

string

required

Time of the delivery as a Unix timestamp in seconds. The signed payload includes this value.

X-Webhook-Signature

string

required

Base64-encoded Ed25519 signature of {X-Webhook-Timestamp}.{raw body}.

Body

application/json

The event.

Envelope of each webhook event.

string

required

Unique identifier of the event. Each retry of a delivery has the same id. Use the id to process each event only one time.

type

enum<string>

required

Type of the event.

Available options:

account.balance.changed

createdAt

string<date-time>

required

Time of the event.

data

object

required

Payload of the event.

Show child attributes

Example:

{
  "accountId": "019cbf58-1b2a-7c3d-9e4f-5a6b7c8d9e0f",
  "balances": [
    {
      "currency": "EUR",
      "decimals": 18,
      "spendable": "125000000000000000000",
      "nonSpendable": "0",
      "processingDeposits": "0",
      "processingWithdrawals": "0"
    },
    {
      "currency": "GBP",
      "decimals": 18,
      "spendable": "0",
      "nonSpendable": "0",
      "processingDeposits": "0",
      "processingWithdrawals": "0"
    },
    {
      "currency": "USD",
      "decimals": 6,
      "spendable": "0",
      "nonSpendable": "0",
      "processingDeposits": "0",
      "processingWithdrawals": "0"
    }
  ],
  "reason": "deposit",
  "referenceId": "019cbf59-0e4d-75ab-a1ce-d6f75f27dd73"
}

Response

2XX

To acknowledge the event, return a 2xx status.