Create a legal entity.
For a full list of required fields, see Required Fields for Individuals and Required Fields for Businesses.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Create a legal_entity for an individual or a business. The required fields depend on the legal_entity_type you set. This page consolidates everything you need to build a valid request; see the linked pages for edge cases.
Required fields for individuals
Set "legal_entity_type": "individual" and include the following:
| Field | Type | Notes |
|---|---|---|
| first_name | string | Legal first name. |
| last_name | string | Legal last name. |
| 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. |
| identifications | array object | See Identification fields. |
Required fields for businesses
Set "legal_entity_type": "business" and include the following:
| Field | Type | Notes |
|---|---|---|
| business_name | string | Legal business name. |
| date_formed | string | Formation date. Format: YYYY-MM-DD. |
| legal_structure | string | One of corporation, llc, non_profit, partnership, sole_proprietorship, trust. |
| 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. |
| addresses | array object | See Address fields. address_types is required for businesses. |
| identifications | array object | See Identification fields. |
Address fields
Each entry in addresses requires line1, locality, region, postal_code, and country. country conforms to ISO 3166-1 alpha-2 (e.g. US). Businesses must also set address_types (e.g. ["business"], ["business_registered"]).
Identification fields
Each entry in identifications requires id_number and id_type. Include issuing_country (ISO 3166-1 alpha-2) unless the id_type already encodes the country (the first two letters of id_type are the ISO country code). For the full list of supported id_type values and their formats, see Identifications.
Country-specific ID requirements and identification-document rules are covered in Onboard an Individual and Onboard a Business.
Example requests
{
"legal_entity_type": "individual",
"first_name": "Jane",
"last_name": "Doe",
"date_of_birth": "1980-05-15",
"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"
}
],
"identifications": [
{
"id_number": "489521234",
"id_type": "us_ssn",
"issuing_country": "US"
}
]
}{
"legal_entity_type": "business",
"business_name": "Acme Technologies Inc.",
"date_formed": "2015-03-01",
"legal_structure": "corporation",
"business_description": "Software development and consulting services.",
"intended_use": "Receiving customer payments and paying vendors.",
"expected_activity_volume": 500000,
"addresses": [
{
"address_types": ["business"],
"line1": "500 Market Street",
"line2": "Suite 400",
"locality": "San Francisco",
"region": "CA",
"postal_code": "94105",
"country": "US"
}
],
"identifications": [
{
"id_number": "451234567",
"id_type": "us_ein",
"issuing_country": "US"
}
]
}For more sample payloads, see Example Requests.