---
title: "Replace a Card"
method: POST
path: "/api/v1/cards/{publicToken}/replace"
tags: ["Cards"]
---

# Replace a Card

`POST /api/v1/cards/{publicToken}/replace`

## Path parameters

- `publicToken` string, required

## Request body

- ReplaceCardRequest — Request object to the ReplaceCard endpont.
  - `moveBalance` boolean, nullable — If true then the balance will move to the new card.
  - `moveLimitAccumulators` boolean, nullable — If true then the limit accumulators will move to the new card.
  - `moveChildCards` boolean, nullable — If true then the child cards associated with the card will move to the new card.
  - `moveExpiryDate` boolean, nullable — Optional field - if true, then move the same expiry date to the new card.
  - `expiryDate` string, date-time, nullable — Optional field - if provided, card is set to the new Expiry Date. Otherwise default from program is used. Should not be set when MoveExpiryDate is true. Format YYYY-MM.
  - `freetext1` string, nullable — Additional fulfilment data used for transferring extra information to the card manufacturer.
  - `freetext2` string, nullable — Additional fulfilment data used for transferring extra information to the card manufacturer.

## Response `200`

Success

- CreateCardResponse — Response object from Create and Replace Card method
  - `publicToken` string, nullable — Public token of the newly created card.
  - `customerReference` string, nullable — Customer Reference (Account number)
  - `embossName` string, nullable — Embossed name of card
  - `maskedPan` string, nullable — Masked PAN
  - `startDate` string, nullable — Start Date (yyyy-MM-dd)
  - `expiryDate` string, nullable — Expiry Date (yyyy-MM-dd)

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `500` — Server Error

---

[API](https://skmtc.dev/thredd/apis/core-cards.md) · [All operations](https://skmtc.dev/thredd/apis/core-cards/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/thredd/core-cards/revisions/841f62def5bf/schema)