Legal Entities

A legal_entity is an entity (person or business) with distinct legal rights. A Counterparty can be associated to a Legal Entity to indicate the legal entity of that party.

AttributeDescription
id
string
Unique identifier for the Legal Entity.
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.
legal_entity_type
string
Type of Legal Entity.

One of: individualor business.
first_name
string
Legal first name of an individual.
last_name
string
Legal last name of an individual.
date_of_birth
string
Date of birth of an individual.

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.
email
string
Email address of the Legal Entity.
website
string
Website of the business.
phone_numbers
array object
An array of phone numbers in E.164 format.

e.g. [{phone_number: "+12061111111"}]
addresses
array object
An array of Legal Entity Addresses.
identifications
array object
An array of Identifications.
metadata
object
Additional data represented as key-value pairs. Both the key and value must be strings. See Metadata.
{
  "id": "8425ab9c-725f-4ef1-8102-a582926e753b",
  "object": "legal_entity",
  "live_mode": true,
  "legal_entity_type": "individual",
  "first_name": "Mauricio",
  "last_name": "Beer",
  "date_of_birth": "1980-06-07",
  "business_name": null,
  "doing_business_as_names": [],
  "email": "[email protected]",
  "website": null,
  "phone_numbers": [
    {
      "phone_number": "+12061111111"
    }
  ],
  "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",
      "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",
      "live_mode": true,
      "id_type": "us_ssn",
      "issuing_country": "US",
      "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",
  "first_name": null,
  "last_name": null,
  "date_of_birth": null,
  "business_name": "Business Name",
  "doing_business_as_names": ["DBA"],
  "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",
      "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"
}