PATCH
/
v2
/
issuing
/
card
/
{card_id}
curl --request PATCH \
  --url https://api.sandbox.solidfi.com/v2/issuing/card/{card_id} \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "label": "Travel Expense Card"
}'
{
  "id": "crd_7948d9a96706dd05360a340002de725f",
  "client_id": "cli_64c6c87ee9d609f36a6f390dc378a4ce",
  "master_account_holder_id": "mah_201e02c581a098a740456c5c19fcfcd6",
  "master_account_id": "mas_743fa071316bc6beaf5dddfd05f49c30",
  "sub_account_holder_id": "sah_5ccfeef0adf0cbe2aa0980d2c9505752",
  "sub_account_id": "sub_bda1e562657c41e553104b10aad3fe70",
  "card_holder_id": "cah_a120a61f60dfd40fdb07b2e8bcd1f6f0",
  "label": "Travel",
  "product": "business_spend",
  "theme": "metallic",
  "type": "physical",
  "expiry_month": "12",
  "expiry_year": "2022",
  "last4": "5275",
  "card_fulfilment": {
    "embossing": {
      "card_holder_name": "John Doe",
      "business_name": "Ace Inc"
    },
    "shipping_address": {
      "line1": "123 Main St",
      "line2": "",
      "city": "New York",
      "state": "NY",
      "country": "US",
      "postal_code": "10001"
    },
    "tracking": {
      "status": "delivered",
      "eta": "2024-05-02",
      "number": "1231233",
      "url": "https://tools.usps.com/go/TrackConfirmAction_input?strOrigTrackNum=120635849224",
      "provider": "usps"
    }
  },
  "controls": {
    "allowed": {
      "merchants": [],
      "categories": [],
      "countries": []
    },
    "blocked": {
      "merchants": [],
      "categories": [],
      "countries": []
    },
    "limit": {
      "period": "daily",
      "max_spend_amount": "500.00",
      "max_spend_per_transaction": "100.00",
      "max_spend_count": "10"
    },
    "atm_enabled": "true"
  },
  "external_reference_id": "FSY52RAZ-4X",
  "attachments": [
    {
      "label": "United",
      "id": "att_a8d2b191fa0e960d8e49a4bfd320e07b",
      "created_at": "2024-04-01T21:00:00Z"
    }
  ],
  "metadata": {
    "description": "Sales Team Card"
  },
  "status": "activated",
  "timestamps": {
    "created_at": "2024-04-01T21:00:00Z",
    "updated_at": "2024-04-02T21:00:00Z",
    "closed_at": "2024-04-02T21:00:00Z"
  }
}

Headers

​
api-key
string
required

API key is required to call Solid APIs. You can view and manage your API keys in the Solid dashboard.

Example:

"{{api_key}}"

Path Parameters

​
card_id
string
required

Body

application/json
​
label
string

label of the card

Example:

"Travel Expense Card"

​
controls
object
​
external_reference_id
string

unique id to cross-reference records with external systems

Example:

"XV-H27LGD-FX"

​
metadata
object

Metadata takes free-form key-value pairs. You may send metadata when you create an object (POST) and when updating the object (PATCH). If you would like to remove metadata that is already on an object, you can unset it by passing in the key-value pair with an empty string, like this: {"key": ""}

​
status
enum<string>

status of the card

Available options:
open,
closed,
blocked
Example:

"open"

Response

200
application/json
Update a Card
​
id
string

unique id of the card

Example:

"crd_7948d9a96706dd05360a340002de725f"

​
client_id
string

unique id of the client that created the card

Example:

"cli_64c6c87ee9d609f36a6f390dc378a4ce"

​
master_account_holder_id
string

unique id of the master account holder

Example:

"mah_201e02c581a098a740456c5c19fcfcd6"

​
master_account_id
string

unique id of the master account

Example:

"mas_743fa071316bc6beaf5dddfd05f49c30"

​
sub_account_holder_id
string

unique id of the sub account holder

Example:

"sah_5ccfeef0adf0cbe2aa0980d2c9505752"

​
sub_account_id
string

unique id of the sub account under which the card was created

Example:

"sub_bda1e562657c41e553104b10aad3fe70"

​
cardholder_id
string

unique id of the card holder

Example:

"cah_a120a61f60dfd40fdb07b2e8bcd1f6f0"

​
label
string

label of the card

Example:

"Travel"

​
product
enum<string>

type of card product configured based on the client's use case

Available options:
business_spend,
consumer_debit,
business_debit,
consumer_gpr,
consumer_gpnr,
consumer_payroll,
consumer_hsa,
consumer_fsa,
consumer_govt_benefits
Example:

"business_spend"

​
theme
string

theme of the card configured as part of the client use case

Example:

"metallic"

​
type
enum<string>

type of card

Available options:
physical,
virtual
Example:

"physical"

​
expiry_month
string

expiration month of the card

Example:

"12"

​
expiry_year
string

expiration year of the card

Example:

"2025"

​
last4
string

last 4 digits of the card number

Example:

"5275"

​
card_fulfilment
object
​
controls
object
​
external_reference_id
string

unique id to cross-reference records with external systems

Example:

"XV-H27LGD-FX"

​
attachments
object[]
​
metadata
object

Metadata takes free-form key-value pairs. You may send metadata when you create an object (POST) and when updating the object (PATCH). If you would like to remove metadata that is already on an object, you can unset it by passing in the key-value pair with an empty string, like this: {"key": ""}

​
status
enum<string>

status of the card

Available options:
open,
closed,
blocked,
locked
Example:

"open"

​
timestamps
object
Retrieve a CardActivate a Card