---
title: "Order a replacement card"
method: POST
path: "/cards/{cardId}/replace"
tags: ["Order a card"]
---

# Order a replacement card

`POST /cards/{cardId}/replace`

Replaces an existing card with a new one.
 A physical card will be replaced with a physical card and a virtual card will be replaced with a virtual card.

## Path parameters

- `cardId` string, uuid, required — The ID of the card to work with.

## Query parameters

- `accountId` string, required — The ID of the account to work with.
- `personId` string, uuid — The ID of the person to work with.

## Request body

- object
  - `keepPan` boolean — Whether or not the new card should keep the same PAN as the old one.
  - `keepDigitalWalletTokens` boolean — Whether or not existing digital wallet tokens should be reassigned to the new card.
  - `expedite` boolean — If set to true, expedited shipping will be used. Product and account settings may block this.

## Response `200`

OK

- object
  - `id` string, uuid — The ID of the card to work with.
  - `personId` string, uuid, nullable — The ID of the person to work with.
  - `accountId` string — The ID of the account to work with.
  - `careOfLine` string, nullable — Adds the specified value as a C/O (care of) line to the mailing carrier.
  - `cardProductName` string — The card product name.
  - `lastFour` string — The last four digits of the card Primary Account Number (PAN).
  - `expiration` string — The expiration month and year of the card.
  - `expirationTime` string — The expiration time of the card.
  - `pinIsSet` boolean — Whether or not the card PIN is set.
  - `state` 'ACTIVE' | 'REPLACED' | 'TERMINATED' | 'SUSPENDED' | 'UNACTIVATED' — The current state of the card.
  - `stateReason` string — The reason for current card state.
  - `fulfillmentStatus` 'ISSUED' | 'ORDERED' | 'REORDERED' | 'REJECTED' | 'SHIPPED' | 'DIGITALLY_PRESENTED' — The fulfillment status of the card.
  - `fulfillment` object, nullable
    - `shippingMethod` 'EXPRESSLOCALMAIL' | 'COURIER' | 'AIRMAIL' | 'STANDARDMAIL', required — Fulfillment provider for the card.
  - `cardType` 'VIRTUAL_PAN' | 'PHYSICAL_MSR' | 'PHYSICAL_COMBO' — The type of card.
  - `recipientAddress` object, nullable — Details about the address that the card will be shipped to.
    - `firstName` string, required — The first name of the card owner.
    - `middleName` string — The middle name of the card owner.
    - `lastName` string, required — The last name of the card owner.
    - `address1` string, required — The first line of the card delivery address.
    - `address2` string — The second line of the card delivery address.
    - `city` string, required — The city of the card delivery address.
    - `state` string — The state/region of the card delivery address.
    - `postalCode` string, required — The postal code or ZIP of the card delivery address.
    - `country` string, required — The country of the card delivery address.
    - `phone` string — The phone number of the card owner.
  - `cardOwnerType` 'PEOPLE' | 'BUDGET' — The card owner type of the card.
  - `name` string — The name of the card.
  - `budgetCardPhoneNumber` string, nullable — The telephone number of the shared card (including area code), prepended by the

---

[API](https://skmtc.net/equalsmoney/apis/cis-api.md) · [All operations](https://skmtc.net/equalsmoney/apis/cis-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/equalsmoney/cis-api/revisions/a162c72b8bf6/schema)