Joint - US
StoneX accepts three types of registration types for US individuals to open joint accounts;
US Joint Registration Type
| Registration Type | Description | 
|---|---|
JointCP | Joint Community Property. Only available to residents of Alaska, Arizona, California,Idaho, Louisiana, Nevada, New Mexico, Philippine Islands, Puerto Rico, Texas, Wisconsin, or Washington | 
JointWROS | Joint with Rights of Survivorship. It is a type of account that is owned by at least two people. | 
JointTIC | Joint Tenants in Common. It refers to a legal relationship in which two or more people own a piece of property or another asset where no rights of survivorship are afforded to any of the account holders. | 
Required Attributes
The below are all the required attributes needed to open a Joint US 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 | Description | 
|---|---|---|---|
nameType | Name Type | ||
name1 | String | 30 | INDIVIDUAL: First Name  ENTITY: Name 1, /, -, # these special characters can be used | 
name3 | String | 30 | INDIVIDUAL: Last 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 | |
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 | 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 | 
Example
- Joint - CP
 - Joint - WROS
 - Joint - TIC
 
{
    "accountNumber": "12345678",
    "subNumber": "301",
    "main": {
        "repCode": "JC01",
        "proxyDisclosure": "L",
        "sweepIndicator": "true",
        "catAccountIdentifier": "Individual"
    },
    "mailingAddress": {
        "country": "US",
        "street": "2 Perimeter Park S Suite 100W",
        "city": "Birmingham",
        "stateProvince": "AL",
        "postalCode": "35243"
    },
    "primaryOwner": {
        "nameType": "Individual",
        "name1": "Sam",
        "name2": "David",
        "name3": "Smith",
        "name4": "JR",
        "citizenshipCountry": "US",
        "birthDate": "1980-05-25",
        "phoneNumberHome": "2056964466",
        "legalAddress": {
            "country": "US",
            "street": "2 Perimeter Park S",
            "city": "Birmingham",
            "stateProvince": "AL",
            "postalCode": "35243"
        },
        "occupation": "accountingOrAuditing",
        "taxIdType": "SSN",
        "taxIdNumber": "123456789",
        "sourceOfFunds": "gift",
        "caisCustomerType": [
            "CP",
            "advisor",
            "Employee"
        ],
        "institutionalInvestor": "true",
        "trustedContact": {
            "name": "Jane Smith",
            "relationship": "spouse",
            "phoneRegionCode": "1",
            "phoneNumber": "2056964444",
            "email": "jane.smith@example.com",
            "address": {
                "country": "US",
                "street": "2 Perimeter Park S Suite 100W",
                "city": "Birmingham",
                "stateProvince": "AL",
                "postalCode": "35243"
            }
        },
        "affiliation": {
            "political": {
                "associated": false
            },
            "industry": {
                "associated": false
            },
            "publicCompany": {
                "associated": false
            },
            "stonex": {
                "associated": false
            }
        }
    },
    "associatedParties": [
        {
            "onbCustomerId": "1234567",
            "role": "secondary",
            "tradingAuthority": "full",
            "nameType": "Individual",
            "name1": "Smith",
            "name3": "Patel",
            "citizenshipCountry": "US",
            "birthDate": "1980-05-25",
            "email": "smith.patel.doe@example.com",
            "taxIdType": "SSN",
            "taxIdNumber": "123456789",
            "governmentIdentification": {
                "governmentId1": {
                    "idType": "driverslicense",
                    "idNumber": "A7654378",
                    "idLocation": "AL",
                    "idIssueDate": "2020-01-01",
                    "idExpiration": "2024-01-01"
                },
                "governmentId2": {
                    "idType": "passport",
                    "idNumber": "E00007734",
                    "idLocation": "US",
                    "idIssueDate": "2020-01-01",
                    "idExpiration": "2030-01-01"
                }
            },
            "legalAddress": {
                "country": "US",
                "street": "2 Perimeter Park S Suite 100W",
                "city": "Birmingham",
                "stateProvince": "AL",
                "postalCode": "35243"
            },
            "occupation": "retired",
            "sourceOfFunds": "retirement",
            "phoneRegionCell": "54",
            "phoneNumberCell": "1143907525",
            "caisCustomerType": [
                "foreign"
            ],
            "institutionalInvestor": false,
            "trustedContact": {
                "name": "Jane Smith",
                "relationship": "spouse",
                "phoneNumber": "2056786578",
                "email": "jane.smith@example.com",
                "address": {
                    "street": "2 Perimeter Park S Suite 100W",
                    "city": "Birmingham",
                    "stateProvince": "AL",
                    "country": "US",
                    "postalCode": "35243"
                }
            },
            "affiliation": {
                "political": {
                    "associated": "true",
                    "name": "Sam Dao",
                    "organization": "Political Organization",
                    "relationship": "self"
                },
                "industry": {
                    "associated": false
                },
                "publicCompany": {
                    "associated": false
                },
                "stonex": {
                    "associated": "true",
                    "name": "David Goldberg",
                    "position": "advisor",
                    "relationship": "self",
                    "affiliatedEntity": "SSIA"
                }
            }
        }
    ],
    "electronicDelivery": {
        "email": "test.person@example.com",
        "statements": false,
        "confirms": true,
        "stonexCommunications": true,
        "investorCommunications": true,
        "prospectus": true,
        "taxDocuments": false
    }
}
{
    "accountNumber": "12345678",
    "subNumber": "301",
    "main": {
        "repCode": "JC01",
        "proxyDisclosure": "L",
        "sweepIndicator": true,
        "catAccountIdentifier": "Individual"
    },
    "mailingAddress": {
        "country": "US",
        "street": "2 Perimeter Park S Suite 100W",
        "city": "Birmingham",
        "stateProvince": "AL",
        "postalCode": "35243"
    },
    "primaryOwner": {
        "nameType": "Individual",
        "name1": "Sam",
        "name2": "David",
        "name3": "Smith",
        "name4": "JR",
        "citizenshipCountry": "US",
        "birthDate": "1980-05-25",
        "phoneNumberHome": "2056964466",
        "legalAddress": {
            "country": "US",
            "street": "2 Perimeter Park S",
            "city": "Birmingham",
            "stateProvince": "AL",
            "postalCode": "35243"
        },
        "occupation": "accountingOrAuditing",
        "taxIdType": "SSN",
        "taxIdNumber": "123456789",
        "sourceOfFunds": "gift",
        "caisCustomerType": [
            "CP",
            "advisor",
            "Employee"
        ],
        "institutionalInvestor": true,
        "trustedContact": {
            "name": "Jane Smith",
            "relationship": "spouse",
            "phoneRegionCode": "1",
            "phoneNumber": "2056964444",
            "email": "jane.smith@example.com",
            "address": {
                "country": "US",
                "street": "2 Perimeter Park S Suite 100W",
                "city": "Birmingham",
                "stateProvince": "AL",
                "postalCode": "35243"
            }
        },
        "affiliation": {
            "political": {
                "associated": false
            },
            "industry": {
                "associated": false
            },
            "publicCompany": {
                "associated": false
            },
            "stonex": {
                "associated": false
            }
        }
    },
    "associatedParties": [
        {
            "onbCustomerId": "1234567",
            "role": "secondary",
            "tradingAuthority": "full",
            "nameType": "Individual",
            "name1": "Smith",
            "name3": "Patel",
            "citizenshipCountry": "US",
            "birthDate": "1980-05-25",
            "email": "smith.patel.doe@example.com",
            "taxIdType": "SSN",
            "taxIdNumber": "123456789",
            "governmentIdentification": {
                "governmentId1": {
                    "idType": "driverslicense",
                    "idNumber": "A7654378",
                    "idLocation": "AL",
                    "idIssueDate": "2020-01-01",
                    "idExpiration": "2024-01-01"
                },
                "governmentId2": {
                    "idType": "passport",
                    "idNumber": "E00007734",
                    "idLocation": "US",
                    "idIssueDate": "2020-01-01",
                    "idExpiration": "2030-01-01"
                }
            },
            "legalAddress": {
                "country": "US",
                "street": "2 Perimeter Park S Suite 100W",
                "city": "Birmingham",
                "stateProvince": "AL",
                "postalCode": "35243"
            },
            "occupation": "retired",
            "sourceOfFunds": "retirement",
            "phoneRegionCell": "54",
            "phoneNumberCell": "1143907525",
            "caisCustomerType": [
                "foreign"
            ],
            "institutionalInvestor": false,
            "trustedContact": {
                "name": "Jane Smith",
                "relationship": "spouse",
                "phoneNumber": "2056786578",
                "email": "jane.smith@example.com",
                "address": {
                    "street": "2 Perimeter Park S Suite 100W",
                    "city": "Birmingham",
                    "stateProvince": "AL",
                    "country": "US",
                    "postalCode": "35243"
                }
            },
            "affiliation": {
                "political": {
                    "associated": "true",
                    "name": "Sam Dao",
                    "organization": "Political Organization",
                    "relationship": "Self"
                },
                "industry": {
                    "associated": "false"
                },
                "publicCompany": {
                    "associated": "false"
                },
                "stonex": {
                    "associated": "true",
                    "name": "David Miller",
                    "position": "Advisor",
                    "relationship": "Self",
                    "affiliatedEntity": "SSIA"
                }
            }
        }
    ],
    "electronicDelivery": {
        "email": "test.person@example.com",
        "statements": false,
        "confirms": true,
        "stonexCommunications": true,
        "investorCommunications": true,
        "prospectus": true,
        "taxDocuments": false
    }
}
{
    "accountNumber": "12345678",
    "subNumber": "301",
    "main": {
        "repCode": "JC01",
        "proxyDisclosure": "L",
        "sweepIndicator": "true",
        "catAccountIdentifier": "Individual"
    },
    "mailingAddress": {
        "country": "US",
        "street": "2 Perimeter Park S Suite 100W",
        "city": "Birmingham",
        "stateProvince": "AL",
        "postalCode": "35216"
    },
    "primaryOwner": {
        "nameType": "Individual",
        "name1": "Sam",
        "name2": "Doe",
        "name3": "Smith",
        "name4": "JR",
        "citizenshipCountry": "US",
        "birthDate": "1980-05-25",
        "phoneNumberHome": "2056964466",
        "legalAddress": {
            "country": "US",
            "street": "2 Perimeter Park S",
            "city": "Birmingham",
            "stateProvince": "AL",
            "postalCode": "35216"
        },
        "occupation": "accountingOrAuditing",
        "taxIdType": "SSN",
        "taxIdNumber": "123456789",
        "sourceOfFunds": "gift",
        "caisCustomerType": [
            "advisor",
            "Employee"
        ],
        "institutionalInvestor": "true",
        "trustedContact": {
            "name": "Jane Smith",
            "relationship": "Spouse",
            "phoneRegionCode": "1",
            "phoneNumber": "2056964444",
            "email": "jane.smith@example.com",
            "address": {
                "country": "BG",
                "street": "193 Noyatola Moghbazar",
                "city": "Dhaka",
                "postalCode": "1217"
            }
        },
        "affiliation": {
            "political": {
                "associated": false
            },
            "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": "AL12345",
                    "idLocation": "AL",
                    "idIssueDate": "2020-01-01",
                    "idExpiration": "2024-01-01"
                },
                "governmentId2": {
                    "idType": "passport",
                    "idNumber": "E00007734",
                    "idLocation": "US",
                    "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": "2030-01-01"
            },
            "affiliation": {
                "political": {
                    "associated": "true",
                    "name": "Sam Dao",
                    "organization": "Political Organization",
                    "relationship": "self"
                },
                "industry": {
                    "associated": false
                },
                "publicCompany": {
                    "associated": false
                },
                "stonex": {
                    "associated": "true",
                    "name": "David Douglas",
                    "position": "Advisor",
                    "relationship": "Self",
                    "affiliatedEntity": "SSIA"
                }
            }
        }
    ],
    "electronicDelivery": {
        "email": "test.person@example.com",
        "statements": false,
        "confirms": true,
        "stonexCommunications": true,
        "investorCommunications": true,
        "prospectus": true,
        "taxDocuments": false
    }
}