Skip to main content
POST
/
v2
/
accounts
/
sub_account_holder
/
{sub_account_holder_id}
/
kyb
Submit a KYB
curl --request POST \
  --url https://api.sandbox.solidfi.com/v2/accounts/sub_account_holder/{sub_account_holder_id}/kyb \
  --header 'api-key: <api-key>'
{
  "id": "sah_01929abad28978ae83b24f5141638475",
  "client_id": "cli_01922e0609e877308fe708217311f5c8",
  "master_account_holder_id": "mah_01922e644f1876cd85f8611582db198c",
  "master_account_id": "mas_01922e6530ec79b589b4470cba42cb09",
  "type": "business",
  "person": null,
  "business": {
    "legal_name": "Acme LLC",
    "dba": "Acme LLC",
    "entity_type": "limited_liability_company",
    "id_type": "ein",
    "id_number": "223913234",
    "phone": "+11231231231",
    "email": "[email protected]",
    "formation_date": "1989-08-09",
    "address": {
      "line1": "123 Main St",
      "line2": "",
      "city": "New York",
      "state": "NY",
      "country": "US",
      "postal_code": "10001"
    },
    "kyb": {
      "id": "kyb_01arz3ndektsv4rrffq69g5fav",
      "status": "pass",
      "method": "solid",
      "url": "https://dashboard.solidfi.com/verify?id=kyb_01arz3ndektsv4rrffq69g5fav",
      "details": {
        "name": {
          "status": "pass",
          "reason": null
        },
        "address": {
          "status": "pass",
          "reason": null
        },
        "watchlist": {
          "status": "pass",
          "reason": null
        },
        "fraud": {
          "status": "pass",
          "reason": null
        }
      }
    },
    "members": [
      {
        "id": "mem_01929abad17f7c2e80a766a5d4a38b39",
        "first_name": "Jane",
        "middle_name": "",
        "last_name": "Doe",
        "id_type": "ssn",
        "id_number": "223902214",
        "date_of_birth": "1974-08-09",
        "phone": "+11231231231",
        "email": "[email protected]",
        "address": {
          "line1": "123 Main St",
          "line2": "",
          "city": "New York",
          "state": "NY",
          "country": "US",
          "postal_code": "10001"
        },
        "kyc": {
          "id": "kyc_01arz3ndektsv4rrffq69g5fav",
          "status": "pass",
          "method": "solid",
          "url": "https://dashboard.solidfi.com/verify?id=kyc_01arz3ndektsv4rrffq69g5fav",
          "details": {
            "name": {
              "status": "pass",
              "reasons": null
            },
            "address": {
              "status": "pass",
              "reasons": null
            },
            "dob": {
              "status": "pass",
              "reasons": null
            },
            "ssn": {
              "status": "pass",
              "reasons": null
            },
            "phone": {
              "status": "pass",
              "reasons": null
            },
            "email": {
              "status": "pass",
              "reasons": null
            },
            "watchlist": {
              "status": "pass",
              "reasons": null
            },
            "fraud": {
              "status": "pass",
              "reasons": null
            }
          }
        },
        "idv": {
          "id": "idv_01arz3ndektsv4rrffq69g5fav",
          "status": "pass",
          "method": "solid",
          "url": "https://dashboard.solidfi.com/id=idv_01arz3ndektsv4rrffq69g5fav",
          "reasons": null
        },
        "ownership": "50.00",
        "designation": "president",
        "title": "",
        "control_person": "true"
      }
    ]
  },
  "ofac": {
    "status": "passed",
    "last_updated_at": "2024-10-17T13:46:27Z"
  },
  "external_reference_id": "xyz-123-qwerp",
  "purpose": "Acme sub account holder",
  "attachments": null,
  "metadata": {
    "customer_code": "1501"
  },
  "status": "activated",
  "timestamps": {
    "created_at": "2024-10-17T13:46:27Z",
    "updated_at": "",
    "deactivated_at": ""
  }
}

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

​
sub_account_holder_id
string
required

Response

Submit a KYB

​
id
string

unique id of the sub account holder

Example:

"sah_5ccfeef0adf0cbe2aa0980d2c9505752"

​
client_id
string

unique id of the client that created the sub account

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"

​
person
object
​
business
object
​
ofac
object
​
external_reference_id
string

unique id to cross-reference records with external systems

Example:

"TW-9L1L2-UVV"

​
purpose
string

purpose of sub account holder

Example:

"Ace sub-account holder"

​
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 sub account holder

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

"activated"

​
timestamps
object