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

# POST /user/{userID}/card/{cardID}/replace

`POST /user/{userID}/card/{cardID}/replace`

Request a card replacement.

## Path parameters

- `userID` integer, required
- `cardID` 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

- CardReplace
  - `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.
  - `preferred_name_on_card` string — The user's preferred name that can be put on the card.
  - `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`

It is possible to order a card replacement with the bunq API.<br/><br/>You can order up to one free card replacement per year. Additional replacement requests will be billed.<br/><br/>The card replacement will have the same expiry date and the same pricing as the old card, but it will have a new card number. You can change the description and optional the PIN through the card replacement endpoint.

- CardReplaceCreate
  - `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)