> For the complete documentation index, see [llms.txt](https://partner.doc.bunq.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://partner.doc.bunq.com/documentation/bunq-as-a-service/chapter-4-monetary-accounts/eur-monetary-account.md).

# EUR Monetary Account

## Create Bank Account in EUR

> Create a new bank monetary account that can hold EUR.

```json
{"openapi":"3.1.0","info":{"title":"bunq Partner API","version":"1.0.0"},"tags":[{"name":"Account Management","description":"Bank and external account management"}],"servers":[{"url":"https://partner-api.sandbox.bunq.com","description":"Sandbox Partner API Server"},{"url":"https://api.partner.bunq.com","description":"Production Partner API Server"}],"security":[{"SessionAuth":[]},{"ClientSignature":[]}],"components":{"securitySchemes":{"SessionAuth":{"type":"apiKey","in":"header","name":"X-Bunq-Client-Authentication","description":"Session token received from POST /session-server"},"ClientSignature":{"type":"apiKey","in":"header","name":"X-Bunq-Client-Signature","description":"HMAC-SHA256 signature of request body using private key"}},"parameters":{"CacheControl":{"name":"Cache-Control","in":"header","required":false,"schema":{"type":"string","default":"no-cache"}},"UserAgent":{"name":"User-Agent","in":"header","required":false,"schema":{"type":"string"}},"BunqLanguage":{"name":"X-Bunq-Language","in":"header","required":false,"schema":{"type":"string","default":"en_US"}},"BunqRegion":{"name":"X-Bunq-Region","in":"header","required":false,"schema":{"type":"string","default":"NL"}},"BunqGeolocation":{"name":"X-Bunq-Geolocation","in":"header","required":false,"schema":{"type":"string"}},"BunqClientRequestId":{"name":"X-Bunq-Client-Request-Id","in":"header","required":false,"schema":{"type":"string"}},"BunqClientAuthentication":{"name":"X-Bunq-Client-Authentication","in":"header","required":true,"schema":{"type":"string","description":"Session token from POST /session-server"}},"BunqClientSignature":{"name":"X-Bunq-Client-Signature","in":"header","required":true,"schema":{"type":"string","description":"HMAC-SHA256 signature of request"}}},"schemas":{"Id":{"type":"object","properties":{"id":{"type":"integer","description":"The ID of the created resource"}}}}},"paths":{"/user/{userId}/monetary-account-bank":{"post":{"tags":["Account Management"],"summary":"Create Bank Account in EUR","description":"Create a new bank monetary account that can hold EUR.","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CacheControl"},{"$ref":"#/components/parameters/UserAgent"},{"$ref":"#/components/parameters/BunqLanguage"},{"$ref":"#/components/parameters/BunqRegion"},{"$ref":"#/components/parameters/BunqGeolocation"},{"$ref":"#/components/parameters/BunqClientRequestId"},{"$ref":"#/components/parameters/BunqClientAuthentication"},{"$ref":"#/components/parameters/BunqClientSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["currency"],"properties":{"currency":{"type":"string","description":"Currency as ISO 4217 code"},"description":{"type":"string","description":"Account description","default":"bunq account"},"daily_limit":{"type":"object","description":"Daily spending limit (max 10000 EUR)","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"avatar_uuid":{"type":"string","format":"uuid","description":"UUID of account avatar"},"display_name":{"type":"string","description":"Legal name of user/company"},"country_iban":{"type":"string","description":"Country code for IBAN"}}}}}},"responses":{"200":{"description":"Bank account created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"Response":{"type":"array","items":{"$ref":"#/components/schemas/Id"}}}}}}}}}}}}
```

## Get Bank Account Details

> Get details of a specific bank monetary account

```json
{"openapi":"3.1.0","info":{"title":"bunq Partner API","version":"1.0.0"},"tags":[{"name":"Account Management","description":"Bank and external account management"}],"servers":[{"url":"https://partner-api.sandbox.bunq.com","description":"Sandbox Partner API Server"},{"url":"https://api.partner.bunq.com","description":"Production Partner API Server"}],"security":[{"SessionAuth":[]},{"ClientSignature":[]}],"components":{"securitySchemes":{"SessionAuth":{"type":"apiKey","in":"header","name":"X-Bunq-Client-Authentication","description":"Session token received from POST /session-server"},"ClientSignature":{"type":"apiKey","in":"header","name":"X-Bunq-Client-Signature","description":"HMAC-SHA256 signature of request body using private key"}},"parameters":{"CacheControl":{"name":"Cache-Control","in":"header","required":false,"schema":{"type":"string","default":"no-cache"}},"UserAgent":{"name":"User-Agent","in":"header","required":false,"schema":{"type":"string"}},"BunqLanguage":{"name":"X-Bunq-Language","in":"header","required":false,"schema":{"type":"string","default":"en_US"}},"BunqRegion":{"name":"X-Bunq-Region","in":"header","required":false,"schema":{"type":"string","default":"NL"}},"BunqGeolocation":{"name":"X-Bunq-Geolocation","in":"header","required":false,"schema":{"type":"string"}},"BunqClientRequestId":{"name":"X-Bunq-Client-Request-Id","in":"header","required":false,"schema":{"type":"string"}},"BunqClientAuthentication":{"name":"X-Bunq-Client-Authentication","in":"header","required":true,"schema":{"type":"string","description":"Session token from POST /session-server"}},"BunqClientSignature":{"name":"X-Bunq-Client-Signature","in":"header","required":true,"schema":{"type":"string","description":"HMAC-SHA256 signature of request"}}},"schemas":{"MonetaryAccountBankDetails":{"type":"object","properties":{"id":{"type":"integer"},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"},"alias":{"type":"array","description":"Account aliases (IBAN, email, phone).","items":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","EMAIL","PHONE_NUMBER"]},"value":{"type":"string"},"name":{"type":"string"}}}},"avatar":{"type":"object","description":"Account avatar."},"balance":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"balance_converted":{"allOf":[{"$ref":"#/components/schemas/MonetaryAccountBankDetails/properties/balance"}],"description":"Balance converted to the user's home currency.","type":["null"]},"country":{"type":"string","description":"ISO-3166 country code."},"currency":{"type":"string","description":"ISO 4217 currency code."},"display_name":{"type":"string","description":"Legal name of the account holder."},"daily_limit":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"transaction_limit":{"type":["object","null"],"properties":{"value":{"type":"string"},"currency":{"type":"string"}},"description":"Per-transaction limit, or null if not set."},"overdraft_limit":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"description":{"type":"string"},"public_uuid":{"type":"string","format":"uuid"},"status":{"type":"string","enum":["ACTIVE","BLOCKED","CANCELLED","PENDING_REOPEN","PENDING_ACCEPTANCE","PENDING_CLOSURE","FROZEN"]},"sub_status":{"type":"string","enum":["NONE","REDEMPTION_VOLUNTARY","REDEMPTION_INVOLUNTARY","ONLY_ACCEPTING_INCOMING"]},"timezone":{"type":"string"},"user_id":{"type":"integer"},"monetary_account_profile":{"type":"object"},"setting":{"type":"object","description":"Monetary account settings."},"connected_cards":{"type":"array","items":{"type":"object"}},"budget":{"type":["object","null"]},"credit_line":{"type":["object","null"]},"all_access":{"type":"array","items":{"type":"object"}},"share":{"type":["object","null"],"description":"Share details if this account is shared."},"all_auto_save_id":{"type":"array","items":{"type":"object"},"description":"Auto-save configurations linked to this account."},"fulfillments":{"type":"array","items":{"type":"object"}},"relation_user":{"type":["object","null"],"description":"Relation user linked to this account, or null."},"reason":{"type":["string","null"],"description":"Closure reason. Only present when status is CANCELLED.","enum":["OTHER"]},"reason_description":{"type":["string","null"],"description":"Human-readable closure reason description."}}}}},"paths":{"/user/{userId}/monetary-account-bank/{accountId}":{"get":{"tags":["Account Management"],"summary":"Get Bank Account Details","description":"Get details of a specific bank monetary account","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"accountId","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CacheControl"},{"$ref":"#/components/parameters/UserAgent"},{"$ref":"#/components/parameters/BunqLanguage"},{"$ref":"#/components/parameters/BunqRegion"},{"$ref":"#/components/parameters/BunqGeolocation"},{"$ref":"#/components/parameters/BunqClientRequestId"},{"$ref":"#/components/parameters/BunqClientAuthentication"},{"$ref":"#/components/parameters/BunqClientSignature"}],"responses":{"200":{"description":"Bank account details","content":{"application/json":{"schema":{"type":"object","properties":{"Response":{"type":"array","items":{"type":"object","properties":{"MonetaryAccountBank":{"$ref":"#/components/schemas/MonetaryAccountBankDetails"}}}}}}}}}}}}}}
```

## List Bank Accounts

> Get all bank monetary accounts for the user

```json
{"openapi":"3.1.0","info":{"title":"bunq Partner API","version":"1.0.0"},"tags":[{"name":"Account Management","description":"Bank and external account management"}],"servers":[{"url":"https://partner-api.sandbox.bunq.com","description":"Sandbox Partner API Server"},{"url":"https://api.partner.bunq.com","description":"Production Partner API Server"}],"security":[{"SessionAuth":[]},{"ClientSignature":[]}],"components":{"securitySchemes":{"SessionAuth":{"type":"apiKey","in":"header","name":"X-Bunq-Client-Authentication","description":"Session token received from POST /session-server"},"ClientSignature":{"type":"apiKey","in":"header","name":"X-Bunq-Client-Signature","description":"HMAC-SHA256 signature of request body using private key"}},"parameters":{"CacheControl":{"name":"Cache-Control","in":"header","required":false,"schema":{"type":"string","default":"no-cache"}},"UserAgent":{"name":"User-Agent","in":"header","required":false,"schema":{"type":"string"}},"BunqLanguage":{"name":"X-Bunq-Language","in":"header","required":false,"schema":{"type":"string","default":"en_US"}},"BunqRegion":{"name":"X-Bunq-Region","in":"header","required":false,"schema":{"type":"string","default":"NL"}},"BunqGeolocation":{"name":"X-Bunq-Geolocation","in":"header","required":false,"schema":{"type":"string"}},"BunqClientRequestId":{"name":"X-Bunq-Client-Request-Id","in":"header","required":false,"schema":{"type":"string"}},"BunqClientAuthentication":{"name":"X-Bunq-Client-Authentication","in":"header","required":true,"schema":{"type":"string","description":"Session token from POST /session-server"}},"BunqClientSignature":{"name":"X-Bunq-Client-Signature","in":"header","required":true,"schema":{"type":"string","description":"HMAC-SHA256 signature of request"}}},"schemas":{"MonetaryAccountBank":{"type":"object","properties":{"id":{"type":"integer"},"currency":{"type":"string"},"description":{"type":"string"},"balance":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"status":{"type":"string","enum":["ACTIVE","BLOCKED","CANCELLED","PENDING_REOPEN","PENDING_ACCEPTANCE","PENDING_CLOSURE","FROZEN"]},"sub_status":{"type":"string","enum":["NONE","REDEMPTION_VOLUNTARY","REDEMPTION_INVOLUNTARY","ONLY_ACCEPTING_INCOMING"]}}},"Pagination":{"type":"object","properties":{"future_url":{"type":["string","null"],"description":"URL to poll for results newer than the current real-time window (useful for long-polling; null if not applicable)."},"newer_url":{"type":["string","null"],"description":"URL to fetch the next newer page relative to the current result set (null if at newest page)."},"older_url":{"type":["string","null"],"description":"URL to fetch an older page (null if none)."}}}}},"paths":{"/user/{userId}/monetary-account-bank":{"get":{"tags":["Account Management"],"summary":"List Bank Accounts","description":"Get all bank monetary accounts for the user","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CacheControl"},{"$ref":"#/components/parameters/UserAgent"},{"$ref":"#/components/parameters/BunqLanguage"},{"$ref":"#/components/parameters/BunqRegion"},{"$ref":"#/components/parameters/BunqGeolocation"},{"$ref":"#/components/parameters/BunqClientRequestId"},{"$ref":"#/components/parameters/BunqClientAuthentication"},{"$ref":"#/components/parameters/BunqClientSignature"}],"responses":{"200":{"description":"List of bank accounts","content":{"application/json":{"schema":{"type":"object","properties":{"Response":{"type":"array","items":{"type":"object","properties":{"MonetaryAccountBank":{"$ref":"#/components/schemas/MonetaryAccountBank"}}}},"Pagination":{"$ref":"#/components/schemas/Pagination"}}}}}}}}}}}
```

## Update Bank Account

> Update bank account settings and status. To reopen a cancelled account, set status to PENDING\_REOPEN and sub\_status to NONE; this is permitted for partner-provisioned users without requiring a paid subscription.

```json
{"openapi":"3.1.0","info":{"title":"bunq Partner API","version":"1.0.0"},"tags":[{"name":"Account Management","description":"Bank and external account management"}],"servers":[{"url":"https://partner-api.sandbox.bunq.com","description":"Sandbox Partner API Server"},{"url":"https://api.partner.bunq.com","description":"Production Partner API Server"}],"security":[{"SessionAuth":[]},{"ClientSignature":[]}],"components":{"securitySchemes":{"SessionAuth":{"type":"apiKey","in":"header","name":"X-Bunq-Client-Authentication","description":"Session token received from POST /session-server"},"ClientSignature":{"type":"apiKey","in":"header","name":"X-Bunq-Client-Signature","description":"HMAC-SHA256 signature of request body using private key"}},"parameters":{"CacheControl":{"name":"Cache-Control","in":"header","required":false,"schema":{"type":"string","default":"no-cache"}},"UserAgent":{"name":"User-Agent","in":"header","required":false,"schema":{"type":"string"}},"BunqLanguage":{"name":"X-Bunq-Language","in":"header","required":false,"schema":{"type":"string","default":"en_US"}},"BunqRegion":{"name":"X-Bunq-Region","in":"header","required":false,"schema":{"type":"string","default":"NL"}},"BunqGeolocation":{"name":"X-Bunq-Geolocation","in":"header","required":false,"schema":{"type":"string"}},"BunqClientRequestId":{"name":"X-Bunq-Client-Request-Id","in":"header","required":false,"schema":{"type":"string"}},"BunqClientAuthentication":{"name":"X-Bunq-Client-Authentication","in":"header","required":true,"schema":{"type":"string","description":"Session token from POST /session-server"}},"BunqClientSignature":{"name":"X-Bunq-Client-Signature","in":"header","required":true,"schema":{"type":"string","description":"HMAC-SHA256 signature of request"}}},"schemas":{"Id":{"type":"object","properties":{"id":{"type":"integer","description":"The ID of the created resource"}}}}},"paths":{"/user/{userId}/monetary-account-bank/{accountId}":{"put":{"tags":["Account Management"],"summary":"Update Bank Account","description":"Update bank account settings and status. To reopen a cancelled account, set status to PENDING_REOPEN and sub_status to NONE; this is permitted for partner-provisioned users without requiring a paid subscription.","parameters":[{"name":"userId","in":"path","required":true,"schema":{"type":"integer"}},{"name":"accountId","in":"path","required":true,"schema":{"type":"integer"}},{"$ref":"#/components/parameters/CacheControl"},{"$ref":"#/components/parameters/UserAgent"},{"$ref":"#/components/parameters/BunqLanguage"},{"$ref":"#/components/parameters/BunqRegion"},{"$ref":"#/components/parameters/BunqGeolocation"},{"$ref":"#/components/parameters/BunqClientRequestId"},{"$ref":"#/components/parameters/BunqClientAuthentication"},{"$ref":"#/components/parameters/BunqClientSignature"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"description":{"type":"string"},"daily_limit":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"status":{"type":"string","enum":["ACTIVE","BLOCKED","CANCELLED","PENDING_REOPEN","FROZEN"]},"sub_status":{"type":"string","enum":["NONE","REDEMPTION_VOLUNTARY"]},"reason":{"type":"string","enum":["OTHER"]},"reason_description":{"type":"string"}}}}}},"responses":{"200":{"description":"Bank account updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"Response":{"type":"array","items":{"$ref":"#/components/schemas/Id"}}}}}}}}}}}}
```