Create an individual or business account holder

post

https://sandbox.lithic.com/v1/account_holders

Create an account holder and initiate the appropriate onboarding workflow. Account holders and accounts have a 1:1 relationship. When an account holder is successfully created an associated account is also created. All calls to this endpoint will return a synchronous response. The response time will depend on the workflow. In some cases, the response may indicate the workflow is under review or further action will be needed to complete the account creation process. This endpoint can only be used on accounts that are part of the program that the calling API key manages.

Body Params

beneficial_owner_individuals

array of objects

required

length ≥ 0

You must submit a list of all direct and indirect individuals with 25% or more ownership in the company. A maximum of 4 beneficial owners can be submitted. If no individual owns 25% of the company you do not need to send beneficial owner information. See FinCEN requirements (Section I) for more background on individuals that should be included.

beneficial_owner_individuals*

business_entity

object

required

Information for business for which the account is being opened and KYB is being run.

control_person

object

required

An individual with significant responsibility for managing the legal entity (e.g., a Chief Executive Officer, Chief Financial Officer, Chief Operating Officer, Managing Member, General Partner, President, Vice President, or Treasurer). This can be an executive, or someone who will have program-wide access to the cards that Lithic will provide. In some cases, this individual could also be a beneficial owner listed above. See FinCEN requirements (Section II) for more background.

external_id

string

A user provided id that can be used to link an account holder with an external system

kyb_passed_timestamp

string

An RFC 3339 timestamp indicating when precomputed KYB was completed on the business with a pass result.

This field is required only if workflow type is KYB_BYO.

naics_code

string

6-digit North American Industry Classification System (NAICS) code for the business.

nature_of_business

string

required

Short description of the company's line of business (i.e., what does the company do?). Values longer than 255 characters will be truncated before KYB verification

tos_timestamp

string

required

An RFC 3339 timestamp indicating when the account holder accepted the applicable legal agreements (e.g., cardholder terms) as agreed upon during API customer's implementation with Lithic.

website_url

string

Company website URL.

workflow

string

enum

required

Specifies the type of KYB workflow to run.

Allowed:

Responses


User has not been authenticated	Invalid or missing API key
API key is not active	The API key used is no longer active
Could not find API key	The API key provided is not associated with any user
Please provide API key in Authorization header	The Authorization header is not in the request
Please provide API key in the form Authorization: [api-key]	The Authorization header is not formatted properly
Insufficient privileges. Issuing API key required	Write access requires an Issuing API key. Reach out at lithic.com/contact
Insufficient privileges to create virtual cards.	Creating virtual cards requires an additional privilege


Rate limited, too many requests per second	User has exceeded their per second rate limit
Rate limited, reached daily limit	User has exceeded their daily rate limit
Rate limited, too many keys tried	One IP has queried too many different API keys

200OK

400A parameter in the query given in the request does not match the valid queries for the endpoint.