Custodial

A Custodial account is a financial account opened and managed by an adult for the exclusive benefit of a minor until they reach the age of majority. Once the minor reaches that age, full ownership and control of the account automatically get transferred to them.

Required Attributes

Schema

The below are all the required attributes needed to open a Custodial account.

Attributes	Data Type
entityNumber	Integer
registrationType	String
main	Main
mailingAddress	Mailing Address
primaryOwner	Primary Owner
electronicDelivery	Electronic Delivery
associatedParty	Associated Parties
financialProfile	Financial Profile

Example

{
    "entityNumber": "301",
    "registrationType": "Custodial",
    "main": {
        "repCode": "JC01"
    },
    "electronicDelivery": {
        "email": "[email protected]",
        "statements": "false",
        "confirms": "false",
        "stonexCommunications": "true",
        "investorCommunications": "true",
        "prospectus": "true",
        "taxDocuments": "false"
    },
    "mailingAddress": { 
        "country": "US",
        "street": "1549 Scott Center Rd",
        "city": "Sherman",
        "stateProvince": "AL",
        "postalCode": "14781"
    },
    "primaryOwner": {
        "StateOfGift":"PR",
        "AgeOfMajority":"19",
        "firstname": "John",
        "middlename": "David",
        "lastname": "Doe",
        "suffix": "",
        "citizenshipCountry": "US",
        "birthDate": "1980-05-25",
        "email": "[email protected]",
        "legalAddress": { 
            "street": "62 Blue Spruce Ln",
            "city": "Ballston Lake",
            "stateProvince": "NY",
            "postalCode": "12019",
            "country": "US"
        },
        "occupation": "accountingOrAuditing",
        "employerName": "ABC Accounting",
        "employerPhoneNumber": "5205123987",
        "employerAddress": {
            "street": "2 Perimeter Park S",
            "city": "Birmingham",
            "stateProvince": "AL",
            "country": "US",
            "postalCode": "35243"
        },
        "taxIdType": "TaxId",
        "taxIdNumber": "123456788",
        "governmentIdentification": {
            "governmentId1": {
                "idType": "NationalId",
                "idNumber": "AL12345",
                "idIssueDate": "2020-01-01",
                "idExpiration": "2026-01-01"
            },
            "governmentId2": {
                "idType": "Passport",
                "idNumber": "j123312345",
                "idIssueDate": "2020-01-01",
                "idExpiration": "2026-01-01"
            }
        },
        "sourceOfFunds": [
            "Employment",
            "Other"
        ],
        "othersourceoffund": "OtherTesting",
        "JobTitle": "Software Developer",
        "phoneNumberCell": "2059871212",
        "phoneNumberHome": "9992986495",
        "phoneNumberBusiness": "1234567890",
        "caisInformation": {
            "customerType": [
                "Trust"
            ],
            "AccountType": [
                "Institution",
                "Retirement"
            ],
        "Role": "Auth"
        },
        "trustedContact": { 
            "name": "Jane Smith", 
            "relationship": "spouse", 
            "phoneNumber": "2056786578", 
            "email": "[email protected]", 
            "address": {
                "country": "US", 
                "street": "459 South Segunbagicha", 
                "city": "Ramna", 
                "stateProvince": "NY", 
                "postalCode": "35243" 
            }
        },
        "maritalStatus": "single",
        "dependents": "3"
    },
    "financialProfile": { 
        "annualIncome": "F", 
        "netWorth": "D", 
        "liquidNetWorth": "C", 
        "liquidityNeed": "Medium", 
        "liquidityTime": "High", 
        "taxBracket": "LessThan10", 
        "investmentTimeHorizon": "OneToThreeYears", 
        "investmentProfile": "Conservative", 
        "INVESTMENTEXPERIENCE": {
            "STOCKS": "AVERAGE", 
            "BONDS": "EXTENSIVE", 
            "OPTIONS": "LIMITED",
            "MUTUALFUNDS": "EXTENSIVE",
            "ANNUITIES": "NONE" 
        }
    },
    "associatedParties": [
        {
            "role": "ASSOCIATE",
            "firstName": "Rob",
            "middleName": "Jack",
            "lastName": "TEST1",
            "suffix": "MR",
            "governmentIdentification": {
                "governmentId1": {
                    "idType": "NationalId",
                    "idNumber": "MA1213221",
                    "idIssueDate": "2020-11-11",
                    "idExpiration": "2030-11-11"
                }
            },
            "legalAddress": {
                "city": "BOSTON",
                "stateProvince": "MA",
                "country": "US",
                "postalCode": "22333",
                "street": "2 Perimeter Park S"
            },
            "citizenshipCountry": "US",
            "TaxIdType": "TaxId",
            "TaxIdNumber": "123456789",
            "phoneNumberCell": "2059871212",
            "email": "[email protected]",
            "maritalStatus": "Married",
            "dependents": "02",
            "employerName": "Stonex1",
            "employerPhoneNumber": "5205123987",
            "employerAddress": {
                "city": "BOSTON",
                "stateProvince": "MA",
                "country": "US",
                "postalCode": "21345",
                "street": "2 Perimeter Park S"
            },
            "caisInformation": {
                "customerType": [
                    "Trust"
                ],
                "AccountType": [
                    "Institution",
                    "Retirement"
                ],
            "Role": "Auth"
            },
            "birthDate": "1983-11-11",
            "financialProfile": { 
                "annualIncome": "F",
                "netWorth": "D", 
                "liquidNetWorth": "C",
                "liquidityNeed": "Medium",
                "liquidityTime": "High",
                "taxBracket": "LessThan10",
                "investmentTimeHorizon": "OneToThreeYears",
                "investmentProfile": "Conservative",
                "INVESTMENTEXPERIENCE": {
                    "STOCKS": "LIMITED",
                    "BONDS": "EXTENSIVE",
                    "OPTIONS": "LIMITED",
                    "MUTUALFUNDS": "EXTENSIVE",
                    "ANNUITIES": "NONE"
                }
            }
        }
    ]
}

Note

The registrationType should be equal to Custodial value.

Main

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

Mailing Address

See the mailing address object here

Primary Owner

Attributes	Data Type	Max Length	Values
firstname	String	30	INDIVIDUAL: First Name ENTITY: Name 1, /, -, # these special characters can be used
middlename	String	30	INDIVIDUAL: Middle Name ENTITY: Name 2, /, -, # these special characters can be used
lastname	String	30	INDIVIDUAL: Last Name ENTITY: Name 2, /, -, # these special characters can be used
suffix	String	30	INDIVIDUAL: Suffix ENTITY: Name 2, /, -, # these special characters can be used
stateOfGift	Valid US State
ageOfMajority	String	2	0-99
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
caisInformation	Valid C.A.I.S. Values
institutionalInvestor	Boolean
trustedContact	Trusted Contact
affiliation	Affiliation

Electronic Delivery

See the electronic delivery object here

Email Requirement

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

Associated Parties

Note

Must have minimum 1 associated party defined.

Attributes	Data Type	Description	Validations	Values Accepted
role	String	Role of the joint owner.	Required field	Associate
firstName	String	First name of the joint owner.	Required field with maximum 20 characters.	a-Z, 0-9, #, -, \, /,
middleName	String	Middle name of the joint owner.	Required field with maximum 20 characters.	a-Z, 0-9, #, -, \, /,
lastName	String	Last name of the joint owner.	Required field with maximum 20 characters.	a-Z, 0-9, #, -, \, /,
suffix	String	Suffix of the joint owner.	Required field with maximum 20 characters.	a-Z, 0-9, #, -, \, /,
citizenshipCountry	String	Country of the joint owner.	Required field	US
birthDate	String	Date of birth of the joint owner.	Required field	Date Format
email	String	Email address of the joint owner.	Required field with maximum 50 characters.	Valid Email
taxIdType	String	Tax ID type of the joint owner.	Required field	Valid US Tax ID Type
taxIdNumber	String	Tax ID number of the joint owner.	Required field with exact 9 characters.	0-9
legalAddress	Address Object	Address of the joint owner.	Required field	Legal Address
occupation	String	Occupation of the joint owner.	Required field	Valid Occupation
governmentIdentification	Government Identification Object	Government identification proofs of the joint owner.	Required field	Government Identification
sourceOfFunds	List of String	Source of Funds of the joint owner.	Required field with maximum 5 sources of funds.	Valid Source of Funds
phoneNumberCell	String	Cell phone number of the joint owner.	Required field with 10 - digit phone number.	0-9
caisInformation	List of String	C.A.I.S information of the joint owner.	Required field without special characters.	Valid C.A.I.S Values
employerName	String	Employer name of the joint owner.	Required field if the joint owner role is Secondary.	a-Z, 0-9, #, -, \, /,
employerPhoneNumber	String	Employer phone number of the joint owner.	Required field with 10 - digit phone number if employer name is present.	0-9
employerAddress	Address Object	Employer address of the joint owner.	Require field if employer name is present.	Employer Address

Government Identification

Field Name	Type	Description	Validations	Values Accepted
idType	String	The type of government identification.	Required field with a valid identification type.	Identification Types
idNumber	String	The number related to the identification.	Required 9 character field with first 2 characters a valid US state value if idType is DriversLicense.	US States
idLocation	String	The location related to the identification.	Required field	US for US Individual Accounts
idIssueDate	String	The date on which the identification is issued.	Required field with correct date format and period.	Between birthdate and the current date in proper Date Format.
idExpiration	String	The date on which the identification expires.	Required field with correct date format and period.	Greater than issue date in proper Date Format.

Note

NationalId idType not allowed for US Individual accounts.

Financial Profile

Field Name	Data Type	Description	Validations	Values Accepted
investmentExperience.stocksBonds	String	The stocks information of the user.	Required field with a valid value.	Investment Experience
investmentExperience.options	String	The options information of the user.	Required field with a valid value.	Investment Experience
investmentExperience.mutualFunds	String	The mutual funds information of the user.	Required field with a valid value.	Investment Experience
investmentExperience.annuities	String	The annuities information of the user.	Required field with a valid value.	Investment Experience

Response Example

Custodial

{
            "registrationType": "Custodial",
            "main": {
                "repCode": "JC01",
                "proxyDisclosure": "L"
            },
            "electronicDelivery": {
                "email": "[email protected]",
                "statements": "False",
                "confirms": "False",
                "stonexCommunications": "True",
                "investorCommunications": "True",
                "prospectus": "True",
                "taxDocuments": "False"
            },
            "mailingAddress": {
                "street": "1549 SCOTT CENTER RD",
                "city": "SHERMAN",
                "stateProvince": "AL",
                "country": "US",
                "postalCode": "14781"
            },
            "accountNumber": "10001888",
            "primaryOwner": {
                "sourceOfFunds": [
                    "Employment",
                    "Other"
                ],
                "otherSourceOfFund": "OTHERTESTING",
                "firstName": "JOHN",
                "middleName": "DAVID",
                "lastName": "DOE",
                "citizenshipCountry": "US",
                "birthDate": "1980-05-25",
                "email": "[email protected]",
                "legalAddress": {
                    "street": "62 BLUE SPRUCE LN",
                    "city": "BALLSTON LAKE",
                    "stateProvince": "NY",
                    "country": "US",
                    "postalCode": "12019"
                },
                "occupation": "AccountingOrAuditing",
                "jobTitle": "SOFTWARE DEVELOPER",
                "employerName": "ABC ACCOUNTING",
                "employerPhoneNumber": "5205123987",
                "employerAddress": {
                    "street": "2 PERIMETER PARK S",
                    "city": "BIRMINGHAM",
                    "stateProvince": "AL",
                    "country": "US",
                    "postalCode": "35243"
                },
                "taxIdType": "TaxId",
                "taxIdNumber": "123456788",
                "governmentIdentification": {
                    "governmentId1": {
                        "idType": "NationalId",
                        "idNumber": "AL12345",
                        "idIssueDate": "2020-01-01",
                        "idExpiration": "2026-01-01"
                    },
                    "governmentId2": {
                        "idType": "Passport",
                        "idNumber": "J123312345",
                        "idIssueDate": "2020-01-01",
                        "idExpiration": "2026-01-01"
                    }
                },
                "phoneNumberCell": "2059871212",
                "phoneNumberHome": "9992986495",
                "phoneNumberBusiness": "1234567890",
                "caisInformation": {
                    "customerType": [
                        "Trust"
                    ],
                    "AccountType": [
                        "Institution",
                        "Retirement"
                    ],
                "Role": "Auth"
                },
                "caisAccountType": [],
                "trustedContact": {
                    "name": "JANE SMITH",
                    "relationship": "SPOUSE",
                    "phoneNumber": "2056786578",
                    "email": "[email protected]",
                    "address": {
                        "street": "459 SOUTH SEGUNBAGICHA",
                        "city": "RAMNA",
                        "stateProvince": "NY",
                        "country": "US",
                        "postalCode": "35243"
                    }
                },
                "maritalStatus": "Single",
                "dependents": "3"
            },
            "associatedParties": [
                {
                    "role": "Associate",
                    "financialProfile": {
                        "investmentExperience": {
                            "stocks": "Limited",
                            "bonds": "Extensive",
                            "options": "Limited",
                            "mutualFunds": "Extensive",
                            "annuities": "None"
                        }
                    },
                    "firstName": "ROB",
                    "middleName": "JACK",
                    "lastName": "TEST1",
                    "suffix": "MR",
                    "citizenshipCountry": "US",
                    "birthDate": "1983-11-11",
                    "email": "[email protected]",
                    "legalAddress": {
                        "street": "2 PERIMETER PARK S",
                        "city": "BOSTON",
                        "stateProvince": "MA",
                        "country": "US",
                        "postalCode": "22333"
                    },
                    "employerName": "STONEX1",
                    "employerPhoneNumber": "5205123987",
                    "employerAddress": {
                        "street": "2 PERIMETER PARK S",
                        "city": "BOSTON",
                        "stateProvince": "MA",
                        "country": "US",
                        "postalCode": "21345"
                    },
                    "taxIdType": "TaxId",
                    "taxIdNumber": "123456789",
                    "governmentIdentification": {
                        "governmentId1": {
                            "idType": "NationalId",
                            "idNumber": "MA1213221",
                            "idIssueDate": "2020-11-11",
                            "idExpiration": "2030-11-11"
                        }
                    },
                    "phoneNumberCell": "2059871212",
                    "caisInformation": {
                        "customerType": [
                            "Trust"
                        ],
                        "AccountType": [
                            "Institution",
                            "Retirement"
                        ],
                    "Role": "Auth"
                    },
                    "maritalStatus": "Married",
                    "dependents": "2"
                }
            ],
            "financialProfile": {
                "annualIncome": "F",
                "netWorth": "D",
                "liquidNetWorth": "C",
                "liquidityNeed": "Medium",
                "liquidityTime": "High",
                "taxBracket": "LessThan10",
                "investmentTimeHorizon": "OneToThreeYears",
                "investmentProfile": "Conservative",
                "investmentExperience": {
                    "stocks": "Average",
                    "bonds": "Extensive",
                    "options": "Limited",
                    "mutualFunds": "Extensive",
                    "annuities": "None"
                }
            }