AssociatedPerson
Nested in associated_persons[] on business customers and accepted on the Associated Persons endpoints. Each person represents a UBO (ultimate beneficial owner), controller, signer, or director.
| Field | Type | Required | Notes |
|---|---|---|---|
first_name | string (1–1024) | yes | |
middle_name | string | no | |
last_name | string (2–1024) | yes | |
transliterated_first_name | string | no | |
transliterated_middle_name | string | no | |
transliterated_last_name | string | no | |
email | string (1–1024) | yes | |
phone | string | no | |
birth_date | string (YYYY-MM-DD) | yes | |
residential_address | Address | yes | |
transliterated_residential_address | Address | no | |
has_ownership | boolean | yes | |
has_control | boolean | yes | |
is_signer | boolean | yes | |
is_director | boolean | no | |
title | string | conditional | Required when has_control === true. |
ownership_percentage | integer | no | Required when has_ownership === true and above ownership_threshold. |
attested_ownership_structure_at | string (ISO 8601) | no | |
relationship_established_at | string (YYYY-MM-DD) | no | |
verified_govid_at | string (ISO 8601) | no | |
verified_selfie_at | string (ISO 8601) | no | |
completed_customer_safety_check_at | string (ISO 8601) | no | |
identifying_information | array of IdentifyingInformation | no | |
documents | array of Document | no |
Example
{
"first_name": "Alice",
"last_name": "Zhang",
"email": "alice@example.com",
"birth_date": "1990-04-01",
"residential_address": {
"street_line_1": "1 Market St",
"city": "San Francisco",
"subdivision": "US-CA",
"postal_code": "94105",
"country": "USA"
},
"has_ownership": true,
"has_control": true,
"is_signer": true,
"title": "CEO",
"ownership_percentage": 60
}