Create an individual or business account holder
KybKybDelegatedKycKycExempt
beneficial_owner_individuals
- type: array of objects
- required: true
- 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*
- type: object
- description: Individuals associated with a KYB application. Phone number is optional.
address
- type: object
- required: true
- description: Individual's current address - PO boxes, UPS drops, and FedEx drops are not acceptable; APO/FPO are acceptable. Only USA addresses are currently supported.
dob
- type: string
- required: true
- description: Individual's date of birth, as an RFC 3339 date.
- type: string
- required: true
- description: Individual's email address.
If utilizing Lithic for chargeback processing, this customer email address may be used to communicate dispute status and resolution.
first_name
- type: string
- required: true
- description: Individual's first name, as it appears on government-issued identity documents.
government_id
- type: string
- required: true
- description: Government-issued identification number (required for identity verification and compliance with banking regulations). Social Security Numbers (SSN) and Individual Taxpayer Identification Numbers (ITIN) are currently supported, entered as full nine-digits, with or without hyphens.
last_name
- type: string
- required: true
- description: Individual's last name, as it appears on government-issued identity documents.
phone_number
- type: string
- description: Individual's phone number, entered in E.164 format.
ADD object
business_entity
- type: object
- required: true
- description: Information for business for which the account is being opened and KYB is being run.
control_person
- type: object
- required: true
- description: 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
- type: string
- description: A user provided id that can be used to link an account holder with an external system.
kyb_passed_timestamp
- type: string
- description: 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
- type: string
- description: 6-digit North American Industry Classification System (NAICS) code for the business.
nature_of_business
- type: string
- required: true
- description: 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
- type: string
- required: true
- description: 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
- type: string
- description: Company website URL.
workflow
- type: string
- required: true
- enum: Allowed values are
KYB_BASICorKYB_BYO.
Response Example
{
"account_token": "b68b7424-aa69-4cbc-a946-30d90181b621",
"status": "ACCEPTED",
"status_reasons": [],
"token": "12345678-aa69-4cbc-a946-30d90181b621",
"created": "2024-09-16T20:13:41.865274"
}