---
title: "Convert a virtual card into a physical card"
method: POST
path: "/cards/{cardId}/convert-to-physical"
tags: ["Order a card"]
---

# Convert a virtual card into a physical card

`POST /cards/{cardId}/convert-to-physical`

## Request

- Base URL: `https://api.equalsmoney.com/v2`
- URL: `https://api.equalsmoney.com/v2/cards/{cardId}/convert-to-physical`
- Auth: none required
- TypeScript: <https://skmtc.dev/equalsmoney/apis/cis-api/docs/cards/:cardId/convert-to-physical/post.ts> (a function with typed inputs; its response is checked against the schema)

Converts an active virtual card into a physical 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

- union
  - object
    - `pin` string: the PIN of the card.
    - `addressId` string, uuid, required: The ID of the address to work with.
    - `careOfLine` string: Adds the specified value as a C/O (care of) line to the mailing carrier.
    - `fulfillment` object
      - `shippingMethod` 'EXPRESSLOCALMAIL' | 'COURIER' | 'AIRMAIL' | 'STANDARDMAIL', required: Fulfillment provider for the card.
      - `email` string, email, required: The card owner's email address.
      - `mobileNumber` string, required
  - object
    - `pin` string: the PIN of the card.
    - `recipientAddress` object, nullable, required: 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.
    - `careOfLine` string: Adds the specified value as a C/O (care of) line to the mailing carrier.
    - `fulfillment` object
      - `shippingMethod` 'EXPRESSLOCALMAIL' | 'COURIER' | 'AIRMAIL' | 'STANDARDMAIL', required: Fulfillment provider for the card.
      - `email` string, email, required: The card owner's email address.
      - `mobileNumber` string, required

## Response `201`

Created

- 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.dev/equalsmoney/apis/cis-api.md) - [All operations](https://skmtc.dev/equalsmoney/apis/cis-api/llms.txt) - [OpenAPI document](https://skmtc.dev/equalsmoney/apis/cis-api/revisions/a162c72b8bf6?raw)