These are sample payloads for Legal Entity.
Counterparty-specific requests can be found here.
Creating a Legal Entity
{
"legal_entity_type": "individual",
"first_name": "First",
"last_name": "Last",
"date_of_birth": "2024-02-06",
"email": "[email protected]",
"phone_numbers": [
{
"phone_number": "+12061111111"
}
],
"addresses": [
{
"primary": true,
"line1": "119 5th Ave",
"line2": "Suite 600",
"locality": "New York",
"region": "NY",
"postal_code": "10003",
"country": "US",
"address_types": ["residential"]
}
]
}
{
"legal_entity_type": "business",
"business_name": "Business Name",
"doing_business_as_names": ["DBA"],
"email": "[email protected]",
"website": "http://www.example.com",
"phone_numbers": [
{
"phone_number": "+97213859098921"
}
],
"addresses": [
{
"primary": true,
"line1": "119 5th Ave",
"line2": "Suite 600",
"locality": "New York",
"region": "NY",
"postal_code": "10003",
"country": "US",
"address_types": ["business"]
}
]
}
Creating a Legal Entity with IDs
Take a look at country-specific ID requirements here
{
"legal_entity_type": "individual",
"first_name": "First",
"last_name": "Last",
"date_of_birth": "2024-02-06",
"email": "[email protected]",
"addresses": [
{
"primary": true,
"line1": "119 5th Ave",
"line2": "Suite 600",
"locality": "New York",
"region": "NY",
"postal_code": "10003",
"country": "US",
"address_types": ["residential"]
}
],
"identifications": [
{
"id_number": "12345678901",
"id_type": "br_cpf",
"issuing_country": "BR"
}
]
}
{
"legal_entity_type": "business",
"business_name": "Business Name",
"email": "[email protected]",
"addresses": [
{
"primary": true,
"line1": "119 5th Ave",
"line2": "Suite 600",
"locality": "New York",
"region": "NY",
"postal_code": "10003",
"country": "US",
"address_types": ["residential"]
}
],
"identifications": [
{
"id_number": "12345678901234",
"id_type": "br_cnpj",
"issuing_country": "BR"
}
]
}
Updating IDs on a Legal Entity
Note: This will replace the existing identifications
{
"identifications": [
{
"id_number": "12345678901",
"id_type": "br_cpf",
"issuing_country": "BR"
}
]
}