Update Legal Entity

patch

https://app.moderntreasury.com/api/legal_entities/{id}

Updates a given LegalEntity with new information. If the given LegalEntity has any operational ConnectionLegalEntities at Cross River Bank or Column Bank, the representations at each downstream vendor will also be automatically updated with the new information.

Path Params

string

required

Body Params

risk_rating

string

The risk rating of legal entity. One of: low, medium, high.

prefix

string

An individual's prefix.

first_name

string

An individual's first name.

middle_name

string

An individual's middle name.

last_name

string

An individual's last name.

suffix

string

An individual's suffix.

preferred_name

string

An individual's preferred name.

citizenship_country

string

The ISO 3166-1 alpha-2 country code of the individual's citizenship country.

politically_exposed_person

boolean

Whether the individual is a politically exposed person.

date_of_birth

date

An individual's date of birth (YYYY-MM-DD).

date_formed

date

The business's formation date (YYYY-MM-DD).

business_name

string

The business's legal business name.

doing_business_as_names

array of strings

A list of "Doing Business As" (DBA) / trade names for a business, different than their legal business name. Note: This will replace the existing DBAs.

doing_business_as_names

legal_structure

string

The business's legal structure. One of: corporation, llc, non_profit, partnership, sole_proprietorship, trust.

string

The entity's primary email.

website

string

The entity's primary website URL.

phone_numbers

array of objects

A list of phone numbers in E.164 format. Note: This will replace the existing phone numbers.

phone_numbers

bank_settings

object

Additional bank-specific settings for a legal entity. Note: This will replace the existing bank settings.

wealth_and_employment_details

object

Wealth and employment details for an individual. Note: This will replace the existing wealth and employment details.

compliance_details

object

The compliance details for this legal entity managed by a 3rd party compliance provider.

industry_classifications

array of objects

A list of industry classifications for the legal entity. Note: This will replace the existing identifications.

industry_classifications

addresses

array of objects

A list of addresses for the entity. Note: This will replace the existing addresses.

addresses

legal_entity_associations

array of objects

A list of associations for the legal entity. Note: This will replace the existing associations..

legal_entity_associations

identifications

array of objects

A list of identifications for the legal entity. Note: This will replace the existing identifications.

identifications

metadata

json

Additional data represented as key-value pairs. Both the key and value must be strings.