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

account_holder_token

• Type: uuid
• Required: Yes
• Description: Globally unique identifier for the account holder.

Request body for creating a new beneficial owner or replacing the control person entity on an existing KYB account holder.

address

• Type: object
• Required: Yes
• 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: Yes
• Description: Individual's date of birth, as an RFC 3339 date.

email

• Type: string
• Required: Yes
• 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: Yes
• Description: Individual's first name, as it appears on government-issued identity documents.

last_name

• Type: string
• Required: Yes
• Description: Individual's last name, as it appears on government-issued identity documents.

phone_number

• Type: string
• Required: Yes
• Description: Individual's phone number, entered in E.164 format.

government_id

• Type: string
• Required: Yes
• 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.

type

• Type: string enum
• Required: Yes
• Description: The type of entity to create on the account holder.
  Allowed: BENEFICIAL_OWNER_INDIVIDUAL, CONTROL_PERSON

Response:

200 OK

• Type: object
• Description: Response body for creating a new beneficial owner or replacing the control person entity on an existing KYB account holder.

account_holder_token

• Type: uuid
• Required: Yes
• Description: Globally unique identifier for the account holder.

created

• Type: date-time
• Required: Yes
• Description: Timestamp of when the entity was created.

status

• Type: string enum
• Required: Yes
• Description: Entity verification status.

status_reasons

• Type: array of objects
• Required: Yes
• Description: Reason for the evaluation status.

required_documents

• Type: array of objects
• Required: Yes
• Description: A list of documents required for the entity to be approved.

Example Request

curl --request POST \
     --url https://sandbox.lithic.com/v1/account_holders/account_holder_token/entities \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "type": "BENEFICIAL_OWNER_INDIVIDUAL",
  "first_name": "Timmy",
  "last_name": "Turner",
  "dob": "1991-03-08T08:00:00Z",
  "email": "tim@left-earth.com",
  "phone_number": "+15555555555",
  "government_id": "211-23-1412",
  "address": {
    "address1": "300 Normal Forest Way",
    "city": "Portland",
    "country": "USA",
    "postal_code": "90210",
    "state": "OR"
  }
}
'```

### Example Response
```json
{
  "account_holder_token": "fa68ed76-9d02-4d45-8a3f-782f3b6a8b3f",
  "status": "ACCEPTED",
  "status_reasons": [],
  "token": "49c978db-20c4-46d8-9db4-b0ef28c03533",
  "created": "2024-09-16T20:13:41.865274",
  "required_documents": []
}