---
title: "Add Card"
method: POST
path: "/addCard"
tags: ["Accounts and Cards"]
---

# Add Card

`POST /addCard`

Use the Add Card endpoint to add a new card (<<glossary:PAN>> and <<glossary:CAD>>) to an existing <<glossary:PRN>>. Cards that are created with this endpoint are active upon creation, and the account status is updated to the second position of XAACT. SoFi Tech Solutions recommends that you have only one active card per PRN. As needed, ensure that any previous card has been marked lost, stolen, canceled, or any status but `N`.

Do not use this endpoint to create multiple spending cards that share a central balance. For that use case, SoFi Tech Solutions recommends <a href="doc:real-time-funding" target="_blank">Real-Time Funding</a> or <a href="doc:corporate-credit" target="_blank">Corporate Credit</a> for large numbers of cards, or for small numbers of cards you can create <a href="doc:about-accounts#joint-accounts-and-shared-balances" target="_blank">one primary and multiple secondary accounts</a> that share a balance.

Use this endpoint in scenarios such as these:
- Replacing a virtual card that is lost, stolen, or expired
- Adding another virtual card to a PRN
- Replacing an instant-issue card at a storefront (for card programs with a retail integration)
- Replacing a personalized card

## Response `default`

- object
  - `status_code` integer, nullable, required — The response status code. May return a string for some statuses.
  - `status` string, nullable, required — The condition of a process or response
  - `processing_time` number, float, nullable, required — The time elapsed in processing the transaction
  - `echo` object, nullable, required — A structure that contains transaction ID information
    - `transaction_id` string, nullable, required — An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required — Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required — Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required — A system generated timestamp
  - `rtoken` string, nullable, required — A system-generated ID used for tracking
  - `errors` string[] — A list of errors generated while the request was processed
  - `response_data` object, nullable, required — A structure for the response data. It can be empty but usually will contain information.
    - `pmt_ref_no` string, required — A system-generated account number
    - `product_id` string, required — System-generated integer
    - `galileo_account_number` string, required — System-generated integer account number, also known as balance ID
    - `card_id` string, required — An ID used for the card

---

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