A legal_entity is a person or business with distinct legal rights. Legal Entities can be associated with Counterparties and Internal Accounts.
| Attribute | Description |
|---|---|
| idstring | Unique identifier for the Legal Entity. |
| external_idstring | An optional user-defined unique identifier. |
| legal_entity_type string | Type of Legal Entity. One of: |
| risk_rating string | Risk rating of the Legal Entity. One of: |
| prefix string | Prefix of an individual. |
| first_name string | Legal first name of an individual. |
| middle_name string | Legal middle name of an individual. |
| last_name string | Legal last name of an individual. |
| suffix string | Suffix of an individual. |
| preferred_name string | Preferred name of an individual. |
| citizenship_country string | Citizenship country of an Country code conforms to ISO 3166-1 alpha-2 . |
| politically_exposed_person boolean | Whether the individual is a politically exposed person. |
| date_of_birth string | Date of birth of an Format: YYYY-MM-DD |
| date_formed string | Date of formation of a Format: YYYY-MM-DD |
| business_name string | Legal name of the business. |
| doing_business_as_names array string | List of doing business as names for a business. |
| legal_structure string | Legal structure of the One of |
| bank_settings object | Additional bank-specific settings for a legal entity. See bank-specific docs for available fields for this object. |
| wealth_and_employment_details object | Wealth and employment details for an See bank-specific docs for available fields for this object. |
| identifications array object | An array of Identifications used for Tax IDs, legal entity IDs and other identification numbers. |
| phone_numbers array object | An array of phone numbers in E.164 format. e.g. |
| email string | Email address of the Legal Entity. |
| addresses array object | An array of Legal Entity Addresses. |
| website string | Website of the business. |
| status string | The activation status of the entity. One of Note: Only applicable to legal entities created under a Modern Treasury Payment Accounts connection. All other legal entities will have a static |
| service_provider_legal_entity_id string | The UUID of the service provider legal entity for this legal entity in the service provider tree. Optional. 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. |
| metadata object | Additional data represented as key-value pairs. Both the key and value must be strings. See Metadata. |
| live_mode boolean | This field will be true if this object was created with a production API key or false if created with a test API key. |
{
"id": "8425ab9c-725f-4ef1-8102-a582926e753b",
"object": "legal_entity",
"live_mode": true,
"legal_entity_type": "individual",
"risk_rating": "low",
"first_name": "Mauricio",
"last_name": "Beer",
"date_of_birth": "1980-06-07",
"date_formed": null,
"business_name": null,
"doing_business_as_names": [],
"legal_structure": null,
"email": "[email protected]",
"website": null,
"phone_numbers": [
{
"phone_number": "+12061111111"
}
],
"bank_settings": {
"id": "03af94a0-7f32-46a5-ae29-2b5769d5843f",
"object": "legal_entity_bank_setting",
"live_mode": true,
"backup_withholding_percentage": 10,
"enable_backup_withholding": true,
"privacy_opt_out": true,
"regulation_o": true,
"discarded_at": null,
"created_at": "2024-02-05T17:33:51Z",
"updated_at": "2024-02-05T17:33:51Z"
},
"wealth_and_employment_details": {
"id": "03af94a0-7f32-46a5-ae29-2b5769d5843e",
"object": "legal_entity_wealth_employment_detail",
"live_mode": true,
"employment_status": "employed",
"occupation": "technology",
"industry": "finance",
"income_source": "salary",
"income_state": "CA",
"income_country": "US",
"employer_name": "Modern Treasury",
"employer_state": "CA",
"employer_country": "US",
"source_of_funds": "salary",
"wealth_source": "salary",
"annual_income": 100000
},
"addresses": [
{
"id": "03af94a0-7f32-46a5-ae29-2b5769d5843g",
"object": "legal_entity_address",
"live_mode": true,
"address_types": [],
"line1": "119 5th Ave",
"line2": "Suite 600",
"locality": "New York",
"region": "NY",
"postal_code": "10003",
"country": "US",
"primary": true,
"discarded_at": null,
"created_at": "2024-02-05T17:33:51Z",
"updated_at": "2024-02-05T17:33:51Z"
}
],
"identifications": [
{
"id": "ae02f9c1-c5d1-4bfd-9712-8df10885defa",
"object": "identification",
"expiration_date": "2029-04-14",
"live_mode": true,
"id_type": "us_ssn",
"issuing_country": "US",
"issuing_region": null,
"discarded_at": null,
"created_at": "2024-02-05T17:42:33Z",
"updated_at": "2024-02-05T17:42:33Z"
}
],
"metadata": {},
"discarded_at": null,
"created_at": "2024-02-05T17:42:33Z",
"updated_at": "2024-02-05T17:42:33Z"
}{
"id": "8555c38f-8906-4390-844e-1e9997009313",
"object": "legal_entity",
"live_mode": true,
"legal_entity_type": "business",
"risk_rating": "low",
"first_name": null,
"last_name": null,
"date_of_birth": null,
"date_formed": "2001-06-07",
"business_name": "Business Name",
"doing_business_as_names": ["DBA"],
"legal_structure": ["corporation"],
"email": "[email protected]",
"website": "http://www.example.com",
"phone_numbers": [
{
"phone_number": "+97213859098921"
}
],
"addresses": [
{
"id": "03af94a0-7f32-46a5-ae29-2b5769d5843f",
"object": "legal_entity_address",
"live_mode": true,
"address_types": [],
"line1": "119 5th Ave",
"line2": "Suite 600",
"locality": "New York",
"region": "NY",
"postal_code": "10003",
"country": "US",
"primary": true,
"discarded_at": null,
"created_at": "2024-02-05T17:33:51Z",
"updated_at": "2024-02-05T17:33:51Z"
}
],
"identifications": [
{
"id": "bc6b5ad1-1313-4d5e-b720-0deb99889832",
"object": "identification",
"live_mode": true,
"id_type": "us_ein",
"issuing_country": "US",
"discarded_at": null,
"created_at": "2024-02-05T17:33:51Z",
"updated_at": "2024-02-05T17:33:51Z"
}
],
"metadata": {},
"discarded_at": null,
"created_at": "2024-02-05T17:33:51Z",
"updated_at": "2024-02-05T17:33:51Z"
}