List all Cards

GET

issuing

card

curl --request GET \
  --url https://api.sandbox.solidfi.com/v2/issuing/card \
  --header 'api-key: <api-key>'

{
  "total": 1,
  "data": [
    {
      "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"
      }
    }
  ],
  "has_more": "true",
  "starting_after": "Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky",
  "ending_before": "Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky"
}

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}}"

Query Parameters

sub_account_id

string

unique id of the sub account

Example:

"sub_bda1e562657c41e553104b10aad3fe70"

card_holder_id

string

unique id of the card holder

Example:

"cah_a120a61f60dfd40fdb07b2e8bcd1f6f0"

limit

number

number of records to return

Example:

10

starting_after

string

A cursor for use in pagination. starting_after is an ID that defines your place in the list. For instance, if you make a list request and receive 50 records, ending with Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky, your subsequent call can include starting_after=Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky in order to fetch the next page of the list.

Example:

"Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky"

ending_before

string

A cursor for use in pagination. ending_before is an ID that defines your place in the list. For instance, if you make a list request and receive 50 records, starting with Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky, your subsequent call can include ending_before= Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky in order to fetch the previous page of the list.

Example:

"Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky"

Response

200

application/json

List all Cards

total

number

total number of records

Example:

1

data

object[]

data.id

string

unique id of the card

Example:

"crd_7948d9a96706dd05360a340002de725f"

data.client_id

string

unique id of the client that created the card

Example:

"cli_64c6c87ee9d609f36a6f390dc378a4ce"

data.master_account_holder_id

string

unique id of the master account holder

Example:

"mah_201e02c581a098a740456c5c19fcfcd6"

data.master_account_id

string

unique id of the master account

Example:

"mas_743fa071316bc6beaf5dddfd05f49c30"

data.sub_account_holder_id

string

unique id of the sub account holder

Example:

"sah_5ccfeef0adf0cbe2aa0980d2c9505752"

data.sub_account_id

string

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

Example:

"sub_bda1e562657c41e553104b10aad3fe70"

data.cardholder_id

string

unique id of the card holder

Example:

"cah_a120a61f60dfd40fdb07b2e8bcd1f6f0"

data.label

string

label of the card

Example:

"Travel"

data.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"

data.theme

string

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

Example:

"metallic"

data.type

enum<string>

type of card

Available options:

physical,

virtual

Example:

"physical"

data.expiry_month

string

expiration month of the card

Example:

"12"

data.expiry_year

string

expiration year of the card

Example:

"2025"

data.last4

string

last 4 digits of the card number

Example:

"5275"

data.card_fulfilment

object

data.controls

object

data.external_reference_id

string

unique id to cross-reference records with external systems

Example:

"XV-H27LGD-FX"

data.attachments

object[]

data.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": ""}

data.status

enum<string>

status of the card

Available options:

open,

closed,

blocked,

locked

Example:

"open"

data.timestamps

object

has_more

enum<string>

if there are more records to iterate or not

Available options:

true,

false

Example:

"true"

starting_after

string

Example:

"Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky"

ending_before

string

Example:

"Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky"

Update a Card Holder Create a Card

curl --request GET \
  --url https://api.sandbox.solidfi.com/v2/issuing/card \
  --header 'api-key: <api-key>'

{
  "total": 1,
  "data": [
    {
      "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"
      }
    }
  ],
  "has_more": "true",
  "starting_after": "Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky",
  "ending_before": "Y2xpXzAxOGY4NjEzMDEyYjdlNTFiOTZjNmVlYWJiNmRiZTky"
}

Getting Started

Master Accounts

Sub Account Holders

Sub Accounts

Counterparties

Card Holders

Cards

Transactions

Attachments

Webhooks

Simulation

List all Cards

Headers

Query Parameters

Response