Account Holder

Deactivate a beneficial owner individual

Changed on

Deactivate a beneficial owner individual on an existing KYB account holder. Only beneficial owner individuals can be deactivated.

delete/v1/account_holders/{account_holder_token}/entities/{entity_token}

Request

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

Path parameters

account_holder_tokenstring uuid required

Globally unique identifier for the account holder.

entity_tokenstring uuid required

Globally unique identifier for the entity.

Response

OK

account_holder_tokenstring uuid required

Globally unique identifier for the account holder

tokenstring uuid required

Globally unique identifier for the entity

type'BENEFICIAL_OWNER_INDIVIDUAL' | 'CONTROL_PERSON' required

The type of entity associated with an account holder

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

The status of an entity associated with an account holder

first_namestring nullable required

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

last_namestring nullable required

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

emailstring nullable required

Individual's email address

phone_numberstring nullable required

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

dobstring nullable required

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

Example response

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

Changes

  • 9798275dc379Revision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became optional for the status

    • breaking

      the response property / became optional for the status