Skip to main content
Input object Business owner information for registration. At least one of emailAddress or phoneNumber must be provided. Exactly one owner in the roster must be the control person (isControlPerson: true). Exactly one owner must match the bearer token user by email or phone (the applicant). When the applicant’s isUsPerson is true, they must already have successful SSN (CIP) verification on file. When isUsPerson is false, the applicant must have KYC status PASS or PASS_INTERNATIONAL. isUsPerson is required on EVERY owner in the roster, including the applicant, invited owners and non-beneficial owners. Full KYC fields (dob, address) are required for owners who are not the applicant, not invited, and either a beneficial owner (>= 25% ownership) or the control person.
  • US persons (isUsPerson: true): provide lastFourSsnDigits (exactly 4 digits) with dob and address (SSN path).
  • Non-US persons (isUsPerson: false): provide dob and address without lastFourSsnDigits (document path).
Invited owners (isInvited: true) and non-beneficial owners (< 25%, not control person) only require base contact fields.

​
Input fields

​
String!
required
Owner’s first name.
​
String!
required
Owner’s last name.
​
String
Owner’s email address. Either emailAddress or phoneNumber must be provided.
​
String
Owner’s phone number. Either emailAddress or phoneNumber must be provided. Must include a country calling code (e.g. +1 555 123 4567 or +44 20 7946 0958); numbers without a country code (e.g. a bare 10-digit US number) are rejected. Formatting characters (spaces, dashes, parentheses) are stripped automatically.
​
String!
required
Owner’s title in the company.
​
Int!
required
Percentage of ownership (0-100).
​
Boolean!
required
Whether this owner is the control person for the business. Exactly one owner must be true.
​
Boolean!
required
Whether this owner will be invited to complete verification later. Invited owners require only base contact fields.
​
Boolean
Whether the owner is a US person. REQUIRED on every owner. For the applicant: true requires successful SSN (CIP) verification on file; false requires KYC PASS / PASS_INTERNATIONAL. For full-KYC co-owners: true requires lastFourSsnDigits (SSN path); false uses document verification.
​
String
Last 4 digits of SSN. Required when isUsPerson is true for full-KYC owners. Omit for non-US persons (document verification still requires dob and address).
​
String
Owner’s date of birth (ISO 8601 date, e.g. 1980-01-15). Required when full KYC is required.
​
OwnerAddressInput
Owner’s address. Required when full KYC is required (both SSN and document verification paths).