Updates a given legal entity with new information. Updates are subject to review and approval as part of our KYC processes.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Update a legal_entity. Updates are partial—send only the fields you want to change, so every field below is optional. The fields available depend on the entity's legal_entity_type (which cannot be changed). This page consolidates the fields, formats, and requirements you need to build a valid request; see the linked pages for edge cases.
Name UpdatesName attributes can only be updated for legal entities that have a status of
draft,pending, ordenied.
Updatable fields for individuals
| Field | Type | Notes |
|---|---|---|
| first_name | string | Legal first name. Name updates are restricted to draft/pending/denied entities. |
| last_name | string | Legal last name. Name updates are restricted to draft/pending/denied entities. |
| date_of_birth | string | Format: YYYY-MM-DD. |
| string | Primary email address. | |
| phone_numbers | array object | Each phone_number is in E.164 format, e.g. +12061111111. |
| addresses | array object | See Address fields. |
Updatable fields for businesses
| Field | Type | Notes |
|---|---|---|
| business_name | string | Legal business name. Name updates are restricted to draft/pending/denied entities. |
| date_formed | string | Formation date. Format: YYYY-MM-DD. |
| legal_structure | string | One of corporation, llc, non_profit, partnership, sole_proprietorship, trust. |
| business_designation | string | One of non_operating_business, exempt_financial_institution. |
| business_description | string | A description of the business. |
| intended_use | string | A description of the intended use of the business. |
| expected_activity_volume | number | Monthly expected transaction volume in USD dollars. |
| country_of_incorporation | string | Country code conforms to ISO 3166-1 alpha-2 (e.g. US). |
| addresses | array object | See Address fields. address_types is required for businesses. |
Address fields
If you include addresses, each entry requires line1, locality, and country. region is required for addresses in the US and US territories (AS, GU, MP, PR, UM, VI) and is optional for other countries; postal_code is required for addresses in the US and is optional for other countries. country conforms to ISO 3166-1 alpha-2 (e.g. US). Businesses must also set address_types (e.g. ["business"], ["business_registered"]).
Identifications
Identifications cannot be updated here. Use Create Identification and Update Identification, which change one identification at a time and leave the legal entity's other identifications untouched.
Country-specific ID requirements and identification-document rules are covered in Onboard an Individual and Onboard a Business.
Attaching New DocumentsTo attach new documents to a legal entity utilize the POST /documents endpoint, passing in the legal entity's
idas thedocumentable_id.
Submitting a draft
You can update a draft legal entity as many times as you need. To submit it for processing, send a request whose only attribute is "status": "pending":
{
"status": "pending"
}Submitting moves the legal entity from draft to pending, runs the validation your connection requires, and sends it for processing. Draft child legal entities in its legal_entity_associations are submitted in the same request. If any of them fail validation, the request returns a 422 and every legal entity stays draft. A submitted webhook is sent for each legal entity that is submitted.
statusmust be the only attribute in the request.pendingis the only accepted value, and only while the legal entity isdraft.- A draft child of a draft business can't be submitted on its own. Submit the parent instead.
Example requests
{
"email": "[email protected]",
"phone_numbers": [
{ "phone_number": "+12125550100" }
],
"addresses": [
{
"address_types": ["residential"],
"line1": "123 Main Street",
"locality": "New York",
"region": "NY",
"postal_code": "10001",
"country": "US"
}
]
}{
"business_description": "Software development and consulting services.",
"country_of_incorporation": "US",
"addresses": [
{
"address_types": ["business"],
"line1": "500 Market Street",
"line2": "Suite 400",
"locality": "San Francisco",
"region": "CA",
"postal_code": "94105",
"country": "US"
}
]
}For more sample payloads, see Example Requests.