Update Legal Entity

patch

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

Updates a given legal entity with new information. Updates are subject to review and approval as part of our KYC processes.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

📘
Name Updates
Name attributes can only be updated for legal entities that have a status ofpending or denied.

📘
Attaching New Documents
To attach new documents to a legal entity utilize the POST /documents endpoint, passing in the legal entity's id as the documentable_id.

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

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.

terms_of_use

object | null

Acceptance of terms of use by the legal entity.

Language

Credentials

Basic

base64

Loading…

Response

Click Try It! to start a request and see the response here!