---
title: "PUT /user/{userID}/monetary-account-bank/{itemId}"
method: PUT
path: "/user/{userID}/monetary-account-bank/{itemId}"
tags: ["monetary-account-bank"]
---

# PUT /user/{userID}/monetary-account-bank/{itemId}

`PUT /user/{userID}/monetary-account-bank/{itemId}`

Update a specific existing MonetaryAccountBank.

## Path parameters

- `userID` integer, required
- `itemId` integer, required

## Headers

- `Cache-Control` string
- `User-Agent` string, required
- `X-Bunq-Language` string
- `X-Bunq-Region` string
- `X-Bunq-Client-Request-Id` string
- `X-Bunq-Geolocation` string
- `X-Bunq-Client-Authentication` string, required

## Request body

- MonetaryAccountBank
  - `currency` string — The currency of the MonetaryAccountBank as an ISO 4217 formatted currency code.
  - `description` string — The description of the MonetaryAccountBank. Defaults to 'bunq account'.
  - `daily_limit` Amount
    - `value` string — The amount formatted to two decimal places.
    - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
  - `avatar_uuid` string — The UUID of the Avatar of the MonetaryAccountBank.
  - `status` string — The status of the MonetaryAccountBank. Can be: ACTIVE, BLOCKED, CANCELLED or PENDING_REOPEN
  - `sub_status` string — The sub-status of the MonetaryAccountBank providing extra information regarding the status. Will be NONE for ACTIVE or PENDING_REOPEN, COMPLETELY or ONLY_ACCEPTING_INCOMING for BLOCKED and REDEMPTION_INVOLUNTARY, REDEMPTION_VOLUNTARY or PERMANENT for CANCELLED.
  - `reason` string — The reason for voluntarily cancelling (closing) the MonetaryAccountBank, can only be OTHER.
  - `reason_description` string — The optional free-form reason for voluntarily cancelling (closing) the MonetaryAccountBank. Can be any user provided message.
  - `display_name` string — The legal name of the user / company using this monetary account.
  - `setting` MonetaryAccountSetting
    - `color` string — The color chosen for the MonetaryAccount.
    - `icon` string — The icon chosen for the MonetaryAccount.
    - `default_avatar_status` string — The status of the avatar. Can be either AVATAR_DEFAULT, AVATAR_CUSTOM or AVATAR_UNDETERMINED.
    - `restriction_chat` string — The chat restriction. Possible values are ALLOW_INCOMING or BLOCK_INCOMING
    - `sdd_expiration_action` string — The preference for this monetary account on whether to automatically accept or reject expiring SDDs.
  - `country_iban` string — The country of the monetary account IBAN.
  - `id` integer — The id of the MonetaryAccountBank.
  - `created` string — The timestamp of the MonetaryAccountBank's creation.
  - `updated` string — The timestamp of the MonetaryAccountBank's last update.
  - `avatar` Avatar
    - `uuid` string — The public UUID of the avatar.
    - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
    - `image` Image[] — The actual image information of this avatar.
      - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
      - `content_type` string — The content-type as a MIME filetype.
      - `height` integer — The image height in pixels.
      - `width` integer — The image width in pixels.
    - `style` string — The style (if applicable) for this Avatar.
  - `overdraft_limit` Amount
    - `value` string — The amount formatted to two decimal places.
    - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
  - `balance` Amount
    - `value` string — The amount formatted to two decimal places.
    - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
  - `alias` Pointer[] — The Aliases for the MonetaryAccountBank.
    - `type` string — The alias type, can be: EMAIL|PHONE_NUMBER|IBAN.
    - `value` string — The alias value.
    - `name` string — The alias name.
    - `service` string — The pointer service. Only required for external counterparties.
  - `public_uuid` string — The MonetaryAccountBank's public UUID.
  - `user_id` integer — The id of the User who owns the MonetaryAccountBank.
  - `monetary_account_profile` MonetaryAccountProfile
    - `profile_fill` MonetaryAccountProfileFill
      - `status` string — The status of the profile.
      - `balance_preferred` Amount
        - `value` string — The amount formatted to two decimal places.
        - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
      - `balance_threshold_low` Amount
        - `value` string — The amount formatted to two decimal places.
        - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
      - `issuer` Issuer
        - `bic` string — The BIC code.
        - `name` string — The name of the bank.
    - `profile_drain` MonetaryAccountProfileDrain
      - `status` string — The status of the profile.
      - `balance_preferred` Amount
        - `value` string — The amount formatted to two decimal places.
        - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
      - `balance_threshold_high` Amount
        - `value` string — The amount formatted to two decimal places.
        - `currency` string — The currency of the amount. It is an ISO 4217 formatted currency code.
      - `savings_account_alias` LabelMonetaryAccount
        - `iban` string — The IBAN of the monetary account.
        - `display_name` string — The name to display with this monetary account.
        - `avatar` Avatar
          - `uuid` string — The public UUID of the avatar.
          - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
          - `image` Image[] — The actual image information of this avatar.
            - `attachment_public_uuid` string — The public UUID of the public attachment containing the image.
            - `content_type` string — The content-type as a MIME filetype.
            - `height` integer — The image height in pixels.
            - `width` integer — The image width in pixels.
          - `style` string — The style (if applicable) for this Avatar.
        - `label_user` LabelUser
          - `uuid` string — The public UUID of the label-user.
          - `display_name` string — The name to be displayed for this user, as it was given on the request.
          - `country` string — The country of the user. 000 stands for "unknown"
          - `avatar` Avatar
            - `uuid` string — The public UUID of the avatar.
            - `anchor_uuid` string — The public UUID of object this avatar is anchored to.
            - `image` Image[] — The actual image information of this avatar.
              - …
            - `style` string — The style (if applicable) for this Avatar.
          - `public_nick_name` string — The current nickname of the user.
        - `country` string — The country of the user. Formatted as a ISO 3166-1 alpha-2 country code.
        - `bunq_me` Pointer
          - `type` string — The alias type, can be: EMAIL|PHONE_NUMBER|IBAN.
          - `value` string — The alias value.
          - `name` string — The alias name.
          - `service` string — The pointer service. Only required for external counterparties.
        - `is_light` boolean — Whether or not the monetary account is light.
        - `swift_bic` string — The BIC used for a SWIFT payment.
        - `swift_account_number` string — The account number used for a SWIFT payment. May or may not be an IBAN.
        - `transferwise_account_number` string — The account number used for a Transferwise payment. May or may not be an IBAN.
        - `transferwise_bank_code` string — The bank code used for a Transferwise payment. May or may not be a BIC.
        - `merchant_category_code` string — The merchant category code.
  - `all_auto_save_id` BunqId[] — The ids of the AutoSave.
    - `id` integer — An integer ID of an object. Unique per object type.

## Response `200`

With MonetaryAccountBank you can create a new bank account, retrieve information regarding your existing MonetaryAccountBanks and update specific fields of an existing MonetaryAccountBank. Examples of fields that can be updated are the description, the daily limit and the avatar of the account.<br/><br/>Notification filters can be set on a monetary account level to receive callbacks. For more information check the <a href="/api/1/page/callbacks">dedicated callbacks page</a>.

- MonetaryAccountBankUpdate
  - `Id` BunqId
    - `id` integer — An integer ID of an object. Unique per object type.

## Other responses

- `400` — This is how the error response looks like for 4XX response codes

---

[API](https://skmtc.net/bunq/apis/bunq-api.md) · [All operations](https://skmtc.net/bunq/apis/bunq-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bunq/bunq-api/versions/369477c7bd26/schema)