> 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/non-eur-monetary-account.md).

# Non-EUR Monetary Account

## Create External Account in non-EUR currencies.

> Create a new external monetary account that can hold non-EUR currencies

```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-external":{"post":{"tags":["Account Management"],"summary":"Create External Account in non-EUR currencies.","description":"Create a new external monetary account that can hold non-EUR currencies","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","service"],"properties":{"currency":{"type":"string","description":"Currency as ISO 4217 code"},"service":{"type":"string","description":"External service name:\n- `CURRENCY_CLOUD`: Currency Cloud service for multi-currency accounts\n","enum":["CURRENCY_CLOUD"]},"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"}}}}}},"responses":{"200":{"description":"External account created successfully","content":{"application/json":{"schema":{"type":"object","properties":{"Response":{"type":"array","items":{"$ref":"#/components/schemas/Id"}}}}}}}}}}}}
```

## Get External Account Details

> Get details of a specific external 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":{"MonetaryAccountExternal":{"type":"object","properties":{"id":{"type":"integer"},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"},"avatar":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"},"image":{"type":"array","items":{"type":"object","properties":{"attachment_public_uuid":{"type":"string","format":"uuid"},"content_type":{"type":"string"},"height":{"type":"integer"},"width":{"type":"integer"},"url":{"type":"string","format":"uri"}}}}}},"currency":{"type":"string"},"description":{"type":"string"},"service":{"type":"string"},"daily_limit":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"balance":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"status":{"type":"string","enum":["ACTIVE","BLOCKED","CANCELLED","PENDING_REOPEN"]},"sub_status":{"type":"string","enum":["NONE","REDEMPTION_VOLUNTARY"]},"alias":{"type":"array","description":"Account aliases (like IBAN)","items":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","EMAIL","PHONE_NUMBER"]},"value":{"type":"string"},"name":{"type":"string"}}}},"display_name":{"type":"string","description":"Legal name of user/company"},"public_uuid":{"type":"string","format":"uuid","description":"Public UUID for the account"}}}}},"paths":{"/user/{userId}/monetary-account-external/{accountId}":{"get":{"tags":["Account Management"],"summary":"Get External Account Details","description":"Get details of a specific external 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":"External account details","content":{"application/json":{"schema":{"type":"object","properties":{"Response":{"type":"array","items":{"type":"object","properties":{"MonetaryAccountExternal":{"$ref":"#/components/schemas/MonetaryAccountExternal"}}}}}}}}}}}}}}
```

## List External Accounts

> Get all external 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":{"MonetaryAccountExternal":{"type":"object","properties":{"id":{"type":"integer"},"created":{"type":"string","format":"date-time"},"updated":{"type":"string","format":"date-time"},"avatar":{"type":"object","properties":{"uuid":{"type":"string","format":"uuid"},"image":{"type":"array","items":{"type":"object","properties":{"attachment_public_uuid":{"type":"string","format":"uuid"},"content_type":{"type":"string"},"height":{"type":"integer"},"width":{"type":"integer"},"url":{"type":"string","format":"uri"}}}}}},"currency":{"type":"string"},"description":{"type":"string"},"service":{"type":"string"},"daily_limit":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"balance":{"type":"object","properties":{"value":{"type":"string"},"currency":{"type":"string"}}},"status":{"type":"string","enum":["ACTIVE","BLOCKED","CANCELLED","PENDING_REOPEN"]},"sub_status":{"type":"string","enum":["NONE","REDEMPTION_VOLUNTARY"]},"alias":{"type":"array","description":"Account aliases (like IBAN)","items":{"type":"object","properties":{"type":{"type":"string","enum":["IBAN","EMAIL","PHONE_NUMBER"]},"value":{"type":"string"},"name":{"type":"string"}}}},"display_name":{"type":"string","description":"Legal name of user/company"},"public_uuid":{"type":"string","format":"uuid","description":"Public UUID for the account"}}},"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-external":{"get":{"tags":["Account Management"],"summary":"List External Accounts","description":"Get all external 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 external accounts","content":{"application/json":{"schema":{"type":"object","properties":{"Response":{"type":"array","items":{"type":"object","properties":{"MonetaryAccountExternal":{"$ref":"#/components/schemas/MonetaryAccountExternal"}}}},"Pagination":{"$ref":"#/components/schemas/Pagination"}}}}}}}}}}}
```

## Update External Account

> Update external account settings and status

```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-external/{accountId}":{"put":{"tags":["Account Management"],"summary":"Update External Account","description":"Update external account settings and status","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","CANCELLED","PENDING_REOPEN"]},"sub_status":{"type":"string","enum":["NONE","REDEMPTION_VOLUNTARY"]},"reason":{"type":"string","enum":["OTHER"]},"reason_description":{"type":"string"}}}}}},"responses":{"200":{"description":"External account updated successfully","content":{"application/json":{"schema":{"type":"object","properties":{"Response":{"type":"array","items":{"$ref":"#/components/schemas/Id"}}}}}}}}}}}}
```