Individual - Joint - Foreign

Required Attributes

The below are all the required attributes needed to open an Individual Joint Foreign account.

Attributes	Data Type
subNumber	Integer
accountNumber	String
main	Main
mailingAddress	Mailing Address
primaryOwner	Primary Owner
electronicDelivery	Electronic Delivery
associatedParty	Associated Parties

Main

Attributes	Data Type	Length
repCode	String	4
proxyDisclosure	Proxy Disclosure
sweepIndicator	Boolean
catAccountIdentifier	CAT Account Identifier

Mailing Address

Attributes	Data Type	Max Length
country	Countries	1
street	String	30
city	String	15
stateProvince	US States CanadianProvinces	1
postalCode	String	U.S. - 9
		U.S. - 10

Primary Owner

Attributes	Data Type	Max Length
nameType	Name Type
name1	String	30	INDIVIDUAL: First Name ENTITY: Name 1, /, -, # these special characters can be used
name3	String	30	INDIVIDUAL: First Name ENTITY: Name 2, /, -, # these special characters can be used
citizenshipCountry	Countries
birthDate	Date Format
legalAddress	Address
phoneRegionHome	Phone Region Codes
phoneNumberHome	String	15
phoneRegionCell	Phone Region Codes
phoneNumberCell	String	15
phoneRegionBusiness	Phone Region Codes
phoneNumberBusiness	String	15
occupation	Occupation
taxIdType	US Tax ID Types	9
taxIdNumber	String	9
governmentIdentification	Government Identification		For non-citizens of the US, Government ID 1 is a national ID.
sourceOfFunds	Sources of Funds
caisCustomerType	C.A.I.S. Customer Type
institutionalInvestor	Boolean		A bank, savings and loan association, insurance company, registered investment company, investment adviser, or any individual or entity with $50 million or more in assets.
trustedContact	Trusted Contact
affiliation	Affiliation

Requirements

Phone Number: At least one pair of phone information must be provided. Home, Business, or Cell phone. PhoneRegionCode and PhoneNumber.

Affiliation

Industry

Attributes	Data Type
associated	Boolean
firmClearing	Boolean
companyName	String

Political

Attributes	Data Type
associated	Boolean
name	String
organization	String
relationship	String

Public Company

Attributes	Data Type
associated	Boolean
name	String
symbol	String

StoneX

Attributes	Data Type
associated	Boolean
name	String
position	String
relationship	String
affiliatedEntity	Affiliated Entity

Electronic Delivery

Attributes	Data Type
email	String
statements	Boolean
confirms	Boolean
stonexCommunications	Boolean
investorCommunications	Boolean
prospectus	Boolean
taxDocuments	Boolean

Email Requirement

If all electronic delivery elections are false, the email is not required.

Associated Parties

Attributes	Data Type	Max Length	Description
onbCustomerId	String		During staging, the user needs to provide a user-generated onboarding customer ID.
customerID	String		When an account is opened, StoneX gives the user a customer ID.
delete	boolean		Remove the associated party from the account.
role	Associated Party Roles
tradingAuthority	Trading Authority
nameType	Name Type
name1	string	30	INDIVIDUAL: First Name ENTITY: Name 1, /, -, # these special characters can be used
name2	string	30	INDIVIDUAL: Middle Name ENTITY: N/A, /, -, # these special characters can be used
name3	string	30	INDIVIDUAL: Last Name ENTITY: Name 2, /, -, # these special characters can be used
name4	string	30	INDIVIDUAL: Suffix ENTITY: N/A, /, -, # these special characters can be used
citizenshipCountry	Country
birthDate	Date Format
email	String
legalAddress	Address
occupation	Occupation
governmentIdentification	Government Identification		For non-citizens of the US, Government ID 1 is a national ID.
sourceOfFunds	Sources of Funds
phoneRegionHome	Phone Region Codes
phoneNumberHome	String	15
phoneRegionCell	Phone Region Codes
phoneNumberCell	String	15
phoneRegionBusiness	Phone Region Codes
phoneNumberBusiness	String	15
caisCustomerType	CAIS CustomerType
institutionalInvestor	boolean
trustedContact	Trusted Contact
affiliation	Affiliation

Example

Individual - Joint - Foreign

{
  "accountNumber": "12345678",
  "subNumber": "301",
  "main": {
    "repCode": "JC01",
    "proxyDisclosure": "L",
    "sweepIndicator": "true",
    "catAccountIdentifier": "foreign"
  },
  "mailingAddress": {
    "country": "BG",
    "street": "193 Noyatola Moghbazar",
    "city": "Ramna",
    "postalCode": "1217"
  },
  "primaryOwner": {
    "nameType": "Individual",
    "name1": "Samantha",
    "name2": "Gani",
    "name3": "Mitchell",
    "name4": "JR",
    "citizenshipCountry": "BG",
    "birthDate": "1980-05-25",
    "email": "cynthia.meyer.doe@example.com",
    "governmentIdentification": {
      "governmentId1": {
        "idType": "NationalId",
        "idNumber": "345987432",
        "idLocation": "BG",
        "idIssueDate": "2020-01-01",
        "idExpiration": "2024-01-01"
      },
      "governmentId2": {
        "idType": "passport",
        "idNumber": "E00007734",
        "idLocation": "BG",
        "idIssueDate": "2020-01-01",
        "idExpiration": "2030-01-01"
      }
    },
    "legalAddress": {
      "country": "BG",
      "street": "193 Noyatola Moghbazar",
      "city": "Dhaka",
      "postalCode": "1217"
    },
    "occupation": "MedicalOrDental",
    "jobTitle": "dentist",
    "jobIndustry": "healthcareMedicalServices",
    "employerName": "smile Dental",
    "employerPhoneRegionCode": "54",
    "employerPhoneNumber": "1143907595",
    "employerAddress": {
      "country": "BG",
      "street": "459 South Segunbagicha",
      "city": "Ramna",
      "postalCode": "1217"
    },
    "sourceOfFunds": "gift",
    "phoneRegionCell": "54",
    "phoneNumberCell": "1143907595",
    "caisCustomerType": ["FOREIGN"],
    "institutionalInvestor": "false",
    "trustedContact": {
      "name": "Jane Smith",
      "relationship": "spouse",
      "phoneRegionCode": "1",
      "phoneNumber": "2056786578",
      "email": "jane.smith@example.com",
      "address": {
        "country": "BG",
        "street": "459 South Segunbagicha",
        "city": "Ramna",
        "postalCode": "1217"
      }
    },
    "affiliation": {
      "political": {
        "associated": true,
        "name": "Sam Parker",
        "organization": "Political Organization",
        "relationship": "self"
      },
      "industry": {
        "associated": false
      },
      "publicCompany": {
        "associated": false
      },
      "stonex": {
        "associated": false
      }
    }
  },
  "associatedParties": [
    {
      "onbCustomerId": "1234567",
      "role": "secondary",
      "tradingAuthority": "full",
      "nameType": "Individual",
      "name1": "Smith",
      "name3": "Patel",
      "citizenshipCountry": "BG",
      "birthDate": "1980-05-25",
      "email": "smith.patel.doe@example.com",
      "governmentIdentification": {
        "governmentId1": {
          "idType": "driverslicense",
          "idNumber": "A7654378",
          "idLocation": "AL",
          "idIssueDate": "2020-01-01",
          "idExpiration": "2024-01-01"
        },
        "governmentId2": {
          "idType": "passport",
          "idNumber": "E00007734",
          "idLocation": "BG",
          "idIssueDate": "2020-01-01",
          "idExpiration": "2030-01-01"
        }
      },
      "legalAddress": {
        "country": "BG",
        "street": "459 South Segunbagicha",
        "city": "ramna",
        "postalCode": "1217"
      },
      "occupation": "retired",
      "sourceOfFunds": "retirement",
      "phoneRegionCell": "54",
      "phoneNumberCell": "1143907525",
      "caisCustomerType": ["foreign"],
      "institutionalInvestor": false,
      "trustedContact": {
        "declineDate": "2023-01-11"
      },
      "affiliation": {
        "political": {
          "associated": true,
          "name": "Jane Smith",
          "organization": "Political Organization",
          "relationship": "Self"
        },
        "industry": {
          "associated": false
        },
        "publicCompany": {
          "associated": false
        },
        "stonex": {
          "associated": true,
          "name": "david mateo",
          "position": "advisor",
          "relationship": "self",
          "affiliatedEntity": "SSIA"
        }
      }
    }
  ],
  "electronicDelivery": {
    "email": "test.person@example.com",
    "statements": "false",
    "confirms": "true",
    "stonexCommunications": "true",
    "investorCommunications": "true",
    "prospectus": "true",
    "taxDocuments": "false"
  }
}