---
title: "Channel Manager Replace card"
method: POST
path: "/channel-managers/cards/{cardId}/replace"
tags: ["Channel Manager Card"]
---

# Channel Manager Replace card

`POST /channel-managers/cards/{cardId}/replace`

Replace a card, with a reason STOLEN, DAMAGED, LOST, RENEW

## Path parameters

- `cardId` string, required

## Request body

- ChannelmanagerCardReplacementRequest — Replacement
  - `reason` 'STOLEN' | 'DAMAGED' | 'LOST' | 'RENEW', required — The reason for replacing the card. Can be one of DAMAGED (physical only), LOST, STOLEN, RENEW
  - `externalRef` string — Client reference for the newly created card. Maximum of 50 alphanumeric characters (including underscore, hyphen and space).
  - `design` ChannelmanagerProductDesignDetail
    - `cardRef` string, required — Design reference for card
    - `packagingRef` string, required — Design reference for card packaging
  - `expiry` string — ISO 8601 date with year & month components only. The supplied value must be in the future (cannot be the current month) and is _inclusive_ of the specified month. If no expiry is selected, the standard product expiry date will be set
  - `shippingAddress` ChannelmanagerAddressDetail — Address details for the cardholder. Optional for individual customers whose partner has verification type EXTERNAL.
    - `addressLine1` string, required — First line of address
    - `addressLine2` string — Second line of address
    - `postTown` string, required — Post town
    - `postCode` string, required — Postcode
    - `country` 'AT' | 'BE' | 'BG' | 'CY' | 'CZ' | 'DK' | 'EE' | 'FI' | 'FR' | 'DE' | 'GR' | 'HR' | 'HU' | 'IS' | 'IE' | 'IT' | 'LV' | 'LI' | 'LT' | 'LU' | 'MT' | 'NL' | 'NO' | 'PL' | 'PT' | 'RO' | 'SK' | 'SI' | 'ES' | 'SE' | 'AX' | 'AW' | 'BL' | 'CW' | 'GF' | 'GL' | 'GP' | 'ME' | 'MF' | 'MQ' | 'NC' | 'PF' | 'PM' | 'RE' | 'SX' | 'TF' | 'WF' | 'YT' | 'AI' | 'BM' | 'FK' | 'GB' | 'GG' | 'GI' | 'GS' | 'IO' | 'JE' | 'KY' | 'MS' | 'PN' | 'SH' | 'TC' | 'VG', required — Country (ISO 3166 alpha-2 country code)

## Response `201`

Card replaced successfully

- ChannelmanagerCardReplacementResponse
  - `id` string, required — Card identifier. Maximum of 10 alphanumeric characters.
  - `cvv2` string, required — Card CVV2 number.
  - `pan` string, required — Full card PAN.
  - `createdDate` string, date-time, required — The creation date of the card
  - `externalRef` string, required — Client reference for the newly created card.
  - `expiry` string, required — An ISO 8601 date with year & month components only
  - `maxLimit` string, required — Maximum limit which can be set on this card and is the maximum lifetime spend the card can have
  - `managementToken` string — Card Management Token required for API users for additional security when managing sensitive card data

## Other responses

- `400` — Invalid request

---

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