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

# PUT /user/{userID}/card/{itemId}

`PUT /user/{userID}/card/{itemId}`

Update the card details. Allow to change pin code, status, limits, country permissions and the monetary account connected to the card. When the card has been received, it can be also activated through this endpoint.

## 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

- Card
  - `pin_code` string — The plaintext pin code. Requests require encryption to be enabled.
  - `activation_code` string — DEPRECATED: Activate a card by setting status to ACTIVE when the order_status is ACCEPTED_FOR_PRODUCTION.
  - `status` string — The status to set for the card. Can be ACTIVE, DEACTIVATED, LOST, STOLEN or CANCELLED, and can only be set to LOST/STOLEN/CANCELLED when order status is ACCEPTED_FOR_PRODUCTION/DELIVERED_TO_CUSTOMER/CARD_UPDATE_REQUESTED/CARD_UPDATE_SENT/CARD_UPDATE_ACCEPTED. Can only be set to DEACTIVATED after initial activation, i.e. order_status is DELIVERED_TO_CUSTOMER/CARD_UPDATE_REQUESTED/CARD_UPDATE_SENT/CARD_UPDATE_ACCEPTED. Mind that all the possible choices (apart from ACTIVE and DEACTIVATED) are permanent and cannot be changed after.
  - `order_status` string — The order status to set for the card. Set to CARD_REQUEST_PENDING to get a virtual card produced.
  - `card_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.
  - `card_limit_atm` 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.
  - `country_permission` CardCountryPermission[] — The countries for which to grant (temporary) permissions to use the card.
    - `country` string — The country to allow transactions in (e.g. NL, DE).
    - `expiry_time` string — Expiry time of this rule.
    - `id` integer — The id of the card country permission entry.
  - `pin_code_assignment` CardPinAssignment[] — Array of Types, PINs, account IDs assigned to the card.
    - `type` string — PIN type. Can be PRIMARY, SECONDARY or TERTIARY
    - `routing_type` string — Routing type.
    - `pin_code` string — The 4 digit PIN to be assigned to this account.
    - `monetary_account_id` integer — The ID of the monetary account to assign to this pin for the card.
    - `status` string — The status of the card pin assignment.
  - `primary_account_numbers` CardPrimaryAccountNumber[] — Array of PANs and their attributes.
    - `id` integer — The ID for this Virtual PAN.
    - `description` string — The description for this PAN.
    - `status` string — The status for this PAN, only for Online Cards.
    - `monetary_account_id` integer — The ID of the monetary account to assign to this PAN, only for Online Cards.
    - `uuid` string — The UUID for this Virtual PAN.
    - `four_digit` string — The last four digits of the PAN.
    - `type` string — The type of the PAN.
  - `monetary_account_id_fallback` integer — ID of the MA to be used as fallback for this card if insufficient balance. Fallback account is removed if not supplied.
  - `preferred_name_on_card` string — The user's preferred name as it will be on the card.
  - `second_line` string — The second line of text on the card
  - `cancellation_reason` string — The reason for card cancellation.

## Response `200`

Endpoint for retrieving details for the cards the user has access to.

- CardUpdate
  - `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/revisions/369477c7bd26/schema)