Create Legal Entity

post

https://app.moderntreasury.com/api/legal_entities

Create a legal entity.

For a full list of required fields, see Required Fields for Individuals and Required Fields for Businesses.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

legal_entity_type

string

enum

required

The type of legal entity.

Allowed:

risk_rating

string

enum

The risk rating of legal entity.

Allowed:

prefix

string

An individual's prefix.

first_name

string

An individual's first name. Required for individuals.

middle_name

string

An individual's middle name.

last_name

string

An individual's last name. Required for individuals.

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). Required for individuals.

date_formed

date

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

business_name

string

The business's legal business name. Required for businesses.

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.

doing_business_as_names

legal_structure

string

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

identifications

array of objects

A list of identifications for the legal entity. Required for both individuals and businesses.

identifications

phone_numbers

array of objects

A list of phone numbers in E.164 format. Required for both individuals and businesses.

phone_numbers

bank_settings

object

Additional bank-specific settings for a legal entity.

wealth_and_employment_details

object

Wealth and employment details for an individual. Source of funds can be submitted for a business.

compliance_details

object

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

industry_classifications

array of objects

A list of industry classifications for the business.

industry_classifications

string

The entity's primary email. Required for individuals.

addresses

array of objects

A list of addresses for the entity. Required for both individuals and businesses.

addresses

website

string

The entity's primary website URL.

metadata

json

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

legal_entity_associations

array of objects

The legal entity associations and its child legal entities. Required for businesses.

legal_entity_associations

business_description

string

A description of the business. Required for businesses.

intended_use

string

A description of the intended use of the business. Required for businesses.

expected_activity_volume

number

Monthly expected transaction volume in USD dollars. Required for businesses.

country_of_incorporation

string

The country code where the business is incorporated in the ISO 3166-1 alpha-2 or alpha-3 formats.

operating_jurisdictions

array of strings

A list of countries where the business operates in the ISO 3166 1 alpha-2 or alpha-3 country code formats.

operating_jurisdictions

primary_social_media_sites

array of strings

A list of primary social media URLs for the business.

primary_social_media_sites

regulators

array of objects

Array of regulatory bodies overseeing the business.

regulators

ticker_symbol

string

Stock ticker symbol for a publicly traded business.

listed_exchange

string

The ISO 10383 market identifier code of the business (e.g., XNAS for NASDAQ, XNYS for NYSE).

connection_id

string

Defaults to the id of the connection designated with an is_default value of true, or the id of an existing, operational connection if only one is available.

Defining the connection_id will associate this legal entity with the identified bank or external connection through the creation of a Connection Legal Entity, if the connection is a valid, operational connection for which downstream connection functionality is supported.

Pass in a value of null to prevent the connection_id from being used.

documents

object

A list of Documents to be created and associated with the legal entity. Required for businesses.

external_id

string

An optional user-defined unique identifier.

service_provider_legal_entity_id

uuid | null

Optional. The UUID of the service provider legal entity for this legal entity in the service provider tree. Used to identify which service provider owns this legal entity (e.g., for a customer of your customer, this would be the ID of the intermediate customer's legal entity). Note: This field requires enablement on your organization.