Sign in

v66

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

Deactivate a beneficial owner individual

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}

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"
  }
}