Account Holder

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

Changed on

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

Request

  • Base URL
    https://sandbox.lithic.com
  • URL
    https://sandbox.lithic.com/v1/account_holders/{account_holder_token}/entities
  • Auth
    API key in header Authorization

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

Changes

  • 9798275dc379Revision changes
    • breaking

      the // request property's minLength was increased from 0 to 1

    • breaking

      the // request property's minLength was increased from 0 to 1

    • warning

      the // request property's maxLength was set to 16

    • warning

      the // request property's maxLength was set to 30

    • info

      the request property // became nullable

    • info

      the request property // became nullable

    • info

      the request property // became optional

    • info

      the request property // became optional