Beneficial Owners

Replace the linked LegalEntity (PII) for a beneficial owner

Changed on

Updates the BeneficialOwner-owned LegalEntity using PUT semantics (full replacement of PII). The BO-LE link is immutable post-create.

put/api/beneficial-owners/{id}/legal-entity

Request

  • Base URL: http://localhost:4100
  • URL: http://localhost:4100/api/beneficial-owners/{id}/legal-entity
  • Auth: none required

Path parameters

idstring uuid required

Beneficial owner ID

Request body

business_namestring nullable
citizenship_countrystring nullable
date_formedstring date nullable
date_of_birthstring date nullable
doing_business_as_namesstring[] nullable
first_namestring nullable
last_namestring nullable
legal_entity_type'individual' | 'business' required
legal_structure'corporation' | 'llc' | 'non_profit' | 'partnership' | 'sole_proprietorship' | 'trust' | 'government' nullable
middle_namestring nullable
politically_exposed_personboolean nullable
preferred_namestring nullable
prefixstring nullable
suffixstring nullable
tenant_idstring uuid required
websitestring uri nullable

Example request

{
  "addresses": [
    null
  ],
  "business_name": "",
  "citizenship_country": "",
  "date_formed": "2020-04-20",
  "date_of_birth": "2020-04-20",
  "doing_business_as_names": [
    ""
  ],
  "first_name": "",
  "identifications": [
    null
  ],
  "last_name": "",
  "legal_entity_type": "individual",
  "legal_structure": "corporation",
  "middle_name": "",
  "phone_numbers": [
    null
  ],
  "politically_exposed_person": false,
  "preferred_name": "",
  "prefix": "",
  "suffix": "",
  "tenant_id": "02ef9c5f-29e6-48fc-9ec3-7ed57ed351f6",
  "website": ""
}

Changes