Monetary Account

The MonetaryAccount is the second most important object you’ll work with—it’s where the money lives. Think of it as a bank account, sub-account, or even a pot, depending on how you use it. Unlike wallets (which are tied directly to cards), a monetary account is always connected to a legal owner—a bunq user.

Most financial operations in the bunq API—like making payments or requesting money—require a monetary-account-id. You can retrieve it by listing all accounts under a user: GET /user/{userId}/monetary-account

🏦 Types of Monetary Accounts

Just like user types, monetary accounts come in a few flavors—each with its own endpoint to make things easier to manage:

  • MonetaryAccountBank – classic personal or business bank accounts GET /user/{userId}/monetary-account-bank

  • MonetaryAccountSavings – regular or auto-savings accounts (including VAT accounts) GET /user/{userId}/monetary-account-savings

  • MonetaryAccountJoint – shared accounts with other bunq users (they’re also legal co-owners) GET /user/{userId}/monetary-account-joint

Each type works slightly differently, but they all follow the same structure and principles. Once you know how to use one, the others are easy to pick up.

Last updated

Was this helpful?