Sign in

v66

latestOpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-042174421.1 MB
Account Holder

Create a new beneficial owner individual or replace the existing control person entity

Create a new beneficial owner individual or replace the control person entity on an existing KYB account holder. This endpoint is only applicable for account holders enrolled through a KYB workflow with the Persona KYB provider. A new control person can only replace the existing one. A maximum of 4 beneficial owners can be associated with an account holder.

post/v1/account_holders/{account_holder_token}/entities

Path parameters

account_holder_tokenstring uuid required

Globally unique identifier for the account holder.

Request body

dobstring required

Individual's date of birth, as an RFC 3339 date.

emailstring required

Individual's email address. If utilizing Lithic for chargeback processing, this customer email address may be used to communicate dispute status and resolution.

first_namestring required

Individual's first name, as it appears on government-issued identity documents.

last_namestring required

Individual's last name, as it appears on government-issued identity documents.

phone_numberstring required

Individual's phone number, entered in E.164 format.

government_idstring required

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

type'BENEFICIAL_OWNER_INDIVIDUAL' | 'CONTROL_PERSON' required

The type of entity associated with an account holder

Example request

{
  "address": {
    "address1": "123 Old Forest Way",
    "city": "Omaha",
    "country": "USA",
    "postal_code": "68022",
    "state": "NE"
  },
  "dob": "1991-03-08 08:00:00",
  "email": "tom@middle-earth.com",
  "first_name": "Tom",
  "last_name": "Bombadil",
  "phone_number": "+15555555555",
  "government_id": "111-23-1412"
}

Response

OK

account_holder_tokenstring uuid required

Globally unique identifier for the account holder

createdstring date-time required

Timestamp of when the entity was created

status'ACCEPTED' | 'INACTIVE' | 'PENDING_REVIEW' | 'REJECTED' required

The status of an entity associated with an account holder

status_reasonsStatusReasons[] required

Reason for the evaluation status

tokenstring uuid required

Globally unique identifier for the entity