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

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

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

Used to replace 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

- CardBatchReplace
  - `cards` CardBatchReplaceEntry[], required — The cards that need to be replaced.
    - `id` integer, required — The ID of the card that needs to be replaced.
    - `name_on_card` string — The user's name as it will be on the card. Check 'card-name' for the available card names for a user.
    - `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.
    - `second_line` string — The second line on the card.

## Response `200`

Used to replace multiple cards in a batch.

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