---
title: "POST /user/{userID}/card-batch"
method: POST
path: "/user/{userID}/card-batch"
tags: ["card-batch"]
---

# POST /user/{userID}/card-batch

`POST /user/{userID}/card-batch`

Used to update multiple cards in a batch.

## Path parameters

- `userID` 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

- CardBatch
  - `cards` CardBatchEntry[], required — The cards that need to be updated.
    - `id` integer, required — The ID of the card that needs to be updated.
    - `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.
    - `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.
    - `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.

## Response `200`

Used to update multiple cards in a batch.

- CardBatchCreate
  - `updated_card_ids` BunqId[] — The ids of the cards that have been updated.
    - `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)