List all Card Holders

GET

issuing

card_holder

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

{
  "total": 1,
  "data": [
    {
      "id": "cah_a120a61f60dfd40fdb07b2e8bcd1f6f0",
      "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",
      "person": {
        "first_name": "John",
        "last_name": "Doe",
        "id_type": "ssn",
        "id_number": "223902234",
        "date_of_birth": "1974-01-25",
        "phone": "+19418405843",
        "email": "john.doe@gmail.com",
        "address": {
          "line1": "123 Main St",
          "line2": "",
          "city": "New York",
          "state": "NY",
          "country": "US",
          "postal_code": "10001"
        }
      },
      "external_reference_id": "6RPD1QW-W75",
      "purpose": "Ace Sales Rep",
      "ofac": {
        "status": "pass",
        "last_updated_at": "2024-04-01T21:00:00Z"
      },
      "metadata": {
        "designation": "Senior Sales Manager",
        "employee_number": "77"
      },
      "attachments": [
        {
          "label": "Employee Badge",
          "id": "att_a8d2b191fa0e960d8e49a4bfd320e07b",
          "created_at": "2024-04-01T21:00:00Z"
        }
      ],
      "status": "activated",
      "timestamps": {
        "created_at": "2024-04-01T21:00:00Z",
        "updated_at": "2024-04-02T21:00:00Z",
        "deactivated_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

master_account_id

string

unique id of the master account

Example:

"mas_743fa071316bc6beaf5dddfd05f49c30"

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 Card Holders

total

number

total number of records

Example:

1

data

object[]

data.id

string

unique id of the card holder

Example:

"cah_a120a61f60dfd40fdb07b2e8bcd1f6f0"

data.client_id

string

unique id of the client that issued 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

Example:

"sub_bda1e562657c41e553104b10aad3fe70"

data.person

object

data.person.first_name

string

first name of the person

Example:

"Jane"

data.person.middle_name

string

middle name of the person

Example:

"Jack"

data.person.last_name

string

last name of the person

Example:

"Doe"

data.person.id_type

enum<string>

type of identity used

Available options:

ssn,

passport,

other

Example:

"ssn"

data.person.id_number

string

if id_type is ssn, id_number must be full SSN
if id_type is passport, id_number must be passport number
if id_type is other, id_number must be unique number of the id

id_number must be unique, as in, you cannot use the same id_number for two different persons

Example:

"945678934"

data.person.date_of_birth

string

date of birth of the person (YYYY-MM-DD)

Example:

"1974-01-01"

data.person.phone

string

phone number of the person (E.164, max 16 chars, starts with +)

Example:

"+19418405843"

data.person.email

string

email of the person

Example:

"jane.doe@gmail.com"

data.person.address

object

data.person.kyc

object

data.person.idv

object

data.external_reference_id

string

unique id to cross-reference records with external systems

Example:

"6RPD1QW-W75"

data.purpose

string

purpose of card holder

Example:

"Ace Sales Rep"

data.ofac

object

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 card holder

Available options:

pending_activation,

activated,

suspended,

deactivated,

locked

Example:

"activated"

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"

Retrieve Bank Info Create a Card Holder

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

{
  "total": 1,
  "data": [
    {
      "id": "cah_a120a61f60dfd40fdb07b2e8bcd1f6f0",
      "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",
      "person": {
        "first_name": "John",
        "last_name": "Doe",
        "id_type": "ssn",
        "id_number": "223902234",
        "date_of_birth": "1974-01-25",
        "phone": "+19418405843",
        "email": "john.doe@gmail.com",
        "address": {
          "line1": "123 Main St",
          "line2": "",
          "city": "New York",
          "state": "NY",
          "country": "US",
          "postal_code": "10001"
        }
      },
      "external_reference_id": "6RPD1QW-W75",
      "purpose": "Ace Sales Rep",
      "ofac": {
        "status": "pass",
        "last_updated_at": "2024-04-01T21:00:00Z"
      },
      "metadata": {
        "designation": "Senior Sales Manager",
        "employee_number": "77"
      },
      "attachments": [
        {
          "label": "Employee Badge",
          "id": "att_a8d2b191fa0e960d8e49a4bfd320e07b",
          "created_at": "2024-04-01T21:00:00Z"
        }
      ],
      "status": "activated",
      "timestamps": {
        "created_at": "2024-04-01T21:00:00Z",
        "updated_at": "2024-04-02T21:00:00Z",
        "deactivated_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 Card Holders

Headers

Query Parameters

Response