Getting Started
Master Accounts
Sub Account Holders
Sub Accounts
Counterparties
Card Holders
Cards
Transactions
- GETList all Transactions
- POSTSub Ledger a Transaction
- POSTOriginate an Intra Account Push
- POSTOriginate an Intra Account Pull
- POSTOriginate an ACH Push
- POSTOriginate an ACH Pull
- POSTOriginate a Domestic Wire
- POSTOriginate an International Wire
- POSTOriginate an RTP Push
- POSTOriginate a FedNow Push
- POSTOriginate a Debit Card Push
- POSTOriginate a Debit Card Pull
- POSTOriginate a Check Send
- POSTOriginate a Check Deposit
- GETRetrieve a Transaction
- PATCHUpdate a Transaction
Attachments
Webhooks
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": ""
}
}Submit a 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 is required to call Solid APIs. You can view and manage your API keys in the Solid dashboard.
"{{api_key}}"
Path Parameters
Response
Submit a KYB
unique id of the sub account holder
"sah_5ccfeef0adf0cbe2aa0980d2c9505752"
unique id of the client that created the sub account
"cli_64c6c87ee9d609f36a6f390dc378a4ce"
unique id of the master account holder
"mah_201e02c581a098a740456c5c19fcfcd6"
unique id of the master account
"mas_743fa071316bc6beaf5dddfd05f49c30"
Show child attributes
Show child attributes
first name of the person
"Jane"
middle name of the person
"Jack"
last name of the person
"Doe"
type of identity used
ssn, passport, other "ssn"
- 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
"945678934"
date of birth of the person (YYYY-MM-DD)
"1974-01-01"
phone number of the person (E.164, max 16 chars, starts with +)
"+19418405843"
email of the person
Show child attributes
Show child attributes
line 1 of the address
"123 Main St"
line 2 of the address
""
city of the address
"New York"
2-Letter US state abbreviation (ex: CA)
"NY"
2-letter abbreviated country code (ex: US)
"US"
postal code
"10001"
Show child attributes
Show child attributes
unique id of the KYC
"kyc_7948d9a96706dd05360a340002de725f"
status of the KYC
pass, fail, review, not_started "pass"
sub account holder verification method. It could be an external vendor(Ex: alloy) or Solid
"solid"
url to the person or business verification result. It could be a link to the external vendor or Solid
"https://dashboard.solidfi.com/id=kyc_7948d9a96706dd05360a340002de725f"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
unique id of the IDV
"idv_7948d9a96706dd05360a340002de725f"
status of the IDV
pass, fail, review, not_started "pass"
sub account holder IDV method. It could be an external vendor(Ex: plaid) or Solid
"solid"
url to the identity verification result. It could be a link to the external vendor or Solid
"https://dashboard.solidfi.com/id=kyc_7948d9a96706dd05360a340002de725f"
Show child attributes
Show child attributes
legal name of the business
"Ace LLC"
doing business as
"Ace Inc"
entity type of the business
sole_proprietor, single_member_llc, limited_liability_company, general_partnership, unlisted_corporation, publicly_traded_corporation, association, non_profit, government_organization, revocable_trust, irrevocable_trust, estate, professional_association, limited_partnership, limited_liability_partnership, professional_corporation "limited_liability_company"
type of the business identity used
ein, other "ein"
- if id_type is ssn, id_number must be full SSN
- if id_type is ein, id_number must be ein 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 businesses
"187654321"
phone number of the business (E.164, max 16 chars, starts with +)
"16604491146"
email of the business
date business was formed (YYYY-MM-DD)
"2018-02-18"
Show child attributes
Show child attributes
line 1 of the address
"123 Main St"
line 2 of the address (optional)
""
city of the address
"New York"
2-Letter US state abbreviation (ex: CA)
"NY"
2-letter abbreviated country code (ex: US)
"US"
postal code
"10001"
Show child attributes
Show child attributes
unique id of the KYB
"kyb_7948d9a96706dd05360a340002de725f"
status of the KYB
pass, fail, review, not_started "pass"
sub account holder verification method. It could be an external vendor(Ex: alloy) or Solid
"solid"
url to the person or business verification result. It could be a link to the external vendor or Solid
"https://dashboard.solidfi.com/id=kyc_7948d9a96706dd05360a340002de725f"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
first name of the person
"Jane"
middle name of the person
"Jack"
last name of the person
"Doe"
type of identity used
ssn, passport, other "ssn"
- 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
"945678934"
date of birth of the person (YYYY-MM-DD)
"1974-01-01"
phone number of the person (E.164, max 16 chars, starts with +)
"+19418405843"
email of the person
Show child attributes
Show child attributes
line 1 of the address
"123 Main St"
line 2 of the address (optional)
""
city of the address
"New York"
2-Letter US state abbreviation (ex: CA)
"NY"
2-letter abbreviated country code (ex: US)
"US"
postal code
"10001"
ownership percentage in the business
50.59
title of the member in the business
"CEO"
true if this member is the control person of the business
true, false "true"
Show child attributes
Show child attributes
unique id of the KYC
"kyc_7948d9a96706dd05360a340002de725f"
status of the KYC
pass, fail, review, not_started "pass"
sub account holder verification method. It could be an external vendor(Ex: alloy) or Solid
"solid"
url to the person or business verification result. It could be a link to the external vendor or Solid
"https://dashboard.solidfi.com/id=kyc_7948d9a96706dd05360a340002de725f"
Show child attributes
Show child attributes
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
Show child attributes
Show child attributes
pass, fail, review, in_review "pass"
unique id to cross-reference records with external systems
"TW-9L1L2-UVV"
purpose of sub account holder
"Ace sub-account holder"
Show child attributes
Show child attributes
unique id of the attachment created
"att_a8d2b191fa0e960d8e49a4bfd320e07b"
label of the attachment
"formation"
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 of sub account holder
pending_activation, activated, suspended, deactivated, locked "activated"
Show child attributes
Show child attributes
date and time at which the sub account holder was created
"2024-04-01T21:00:00Z"
date and time at which the sub account holder was updated
"2024-04-01T21:00:00Z"
date and time at which the sub account holder was deactivated
"2024-04-01T21:00:00Z"