POST
/
v2
/
issuing
/
card_holder
Create a Card Holder
curl --request POST \
  --url https://api.sandbox.solidfi.com/v2/issuing/card_holder \
  --header 'Content-Type: application/json' \
  --header 'api-key: <api-key>' \
  --data '{
  "sub_account_id": "sub_bda1e562657c41e553104b10aad3fe70",
  "person": {
    "first_name": "John",
    "middle_name": "",
    "last_name": "Doe",
    "phone": "+19418405843",
    "email": "john.doe@gmail.com",
    "date_of_birth": "1974-01-25",
    "address": {
      "line1": "123 Main St",
      "line2": "",
      "city": "New York",
      "state": "NY",
      "country": "US",
      "postal_code": "10001"
    }
  },
  "external_reference_id": "6RPD1QW-W75",
  "purpose": "Ace Sales Expense Card",
  "metadata": {
    "designation": "Senior Sales Manager",
    "employee_number": "77"
  }
}'
{
  "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"
  }
}

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

Body

application/json
​
sub_account_id
string

unique id of the sub account

Example:

"sub_bda1e562657c41e553104b10aad3fe70"

​
person
object
​
external_reference_id
string

unique id to cross-reference records with external systems

Example:

"6RPD1QW-W75"

​
purpose
string

purpose of card holder

Example:

"Ace Sales Rep"

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

Response

Create a Card Holder

​
id
string

unique id of the card holder

Example:

"cah_a120a61f60dfd40fdb07b2e8bcd1f6f0"

​
client_id
string

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

Example:

"sub_bda1e562657c41e553104b10aad3fe70"

​
person
object
​
external_reference_id
string

unique id to cross-reference records with external systems

Example:

"6RPD1QW-W75"

​
purpose
string

purpose of card holder

Example:

"Ace Sales Rep"

​
ofac
object
​
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 card holder

Available options:
pending_activation,
activated,
suspended,
deactivated,
locked
Example:

"activated"

​
timestamps
object