Skip to content
Logo

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.

FieldTypeRequiredNotes
first_namestring (1–1024)yes
middle_namestringno
last_namestring (2–1024)yes
transliterated_first_namestringno
transliterated_middle_namestringno
transliterated_last_namestringno
emailstring (1–1024)yes
phonestringno
birth_datestring (YYYY-MM-DD)yes
residential_addressAddressyes
transliterated_residential_addressAddressno
has_ownershipbooleanyes
has_controlbooleanyes
is_signerbooleanyes
is_directorbooleanno
titlestringconditionalRequired when has_control === true.
ownership_percentageintegernoRequired when has_ownership === true and above ownership_threshold.
attested_ownership_structure_atstring (ISO 8601)no
relationship_established_atstring (YYYY-MM-DD)no
verified_govid_atstring (ISO 8601)no
verified_selfie_atstring (ISO 8601)no
completed_customer_safety_check_atstring (ISO 8601)no
identifying_informationarray of IdentifyingInformationno
documentsarray of Documentno

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
}