New Account (Create)
The New Account API is designed to create a new account by validating the provided input data, and persisting the account information to the backend system. It should ensure that all required fields comply with business rules and data integrity constraints before the account is finally established.
POST
/account-api/v1/new-account
Request
The request body of the New Account API must contain the following attributes to ensure efficient input for account creation.
- Schema
- Example
| Attributes | Data Type |
|---|---|
registrationType | Registration Type |
accountNumber | String |
entityNumber | Integer |
main | Main |
mailingAddress | Mailing Address |
primaryOwner | Primary Owner |
electronicDelivery | Electronic Delivery |
financialProfile | Financial Profile |
beneficiaries | Beneficiaries |
associatedParties | AssociatedParties |
{
"entityNumber": "301",
"registrationType": "Individual",
"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",
"city": "Ballston Lake",
"stateProvince": "AL",
"postalCode": "14781"
},
"primaryOwner": {
"firstname": "Johnn",
"middlename": "Davidd",
"lastname": "Doe",
"caisInformation": {
"CustomerType": [
"Advisor",
"Employee"
],
"AccountType": [
"Institution",
"Retirement"
],
"Role": "Auth"
},
"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",
"sourceOfFunds": [
"Employment",
"Other"
],
"othersourceoffund": "OtherTesting",
"JobTitle": "Software Developer",
"phoneNumberCell": "2059871212",
"phoneNumberHome": "9992986495",
"phoneNumberBusiness": "1234567890",
"Affiliation": {
"PublicCompany": "",
"Industry": "",
"Political": "True",
"Relationship": "Child",
"Name": "John Doe",
"Organization": "Example Organization",
"Address": {
"Street": "1234 Elmwood Crescent Avenues Springfields IL boomer",
"City": "Boston",
"PostalCode": "35243",
"Country": "US",
"stateProvince": "AL"
}
},
"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": "B",
"liquidNetWorth": "B",
"liquidityNeed": "None",
"liquidityTime": "Medium",
"taxBracket": "TenToFifteen",
"investmentTimeHorizon": "OneToThreeYears",
"investmentProfile": "Moderate",
"investmentExperience": {
"stocks": "Limited",
"bonds": "None",
"options": "None",
"mutualFunds": "Limited",
"annuities": "Limited"
}
},
"Beneficiaries": [
{
"name": "PRIMARY BENE 1",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2003-07-23",
"taxIdType": "SSN",
"taxIdNumber": "123456770",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Spouse"
},
{
"name": "PRIMARY BENE 2",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2006-01-30",
"taxIdType": "SSN",
"taxIdNumber": "123456771",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Other"
},
{
"name": "PRIMARY BENE 3",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2003-07-23",
"taxIdType": "SSN",
"taxIdNumber": "123456770",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Spouse"
},
{
"name": "PRIMARY BENE 4",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2006-01-30",
"taxIdType": "SSN",
"taxIdNumber": "123456771",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Other"
},
{
"name": "PRIMARY BENE 5",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2003-07-23",
"taxIdType": "SSN",
"taxIdNumber": "123456770",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Spouse"
},
{
"name": "PRIMARY BENE 6",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2006-01-30",
"taxIdType": "SSN",
"taxIdNumber": "123456771",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Other"
},
{
"name": "PRIMARY BENE 7",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2003-07-23",
"taxIdType": "SSN",
"taxIdNumber": "123456770",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Spouse"
},
{
"name": "PRIMARY BENE 8",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2006-01-30",
"taxIdType": "SSN",
"taxIdNumber": "123456771",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Other"
},
{
"name": "PRIMARY BENE 9",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2003-07-23",
"taxIdType": "SSN",
"taxIdNumber": "123456770",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Spouse"
},
{
"name": "PRIMARY BENE 10",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2006-01-30",
"taxIdType": "SSN",
"taxIdNumber": "123456771",
"percentageAllocation": "10",
"primaryContingent": "Primary",
"Relationship": "Other"
}
],
"associatedParties": [
{
"caisInformation": {
"CustomerType": ["Advisor", "CP"],
"AccountType": ["Institution", "Retirement"],
"Role": "Auth"
},
"role": "SECONDARY",
"firstName": "Rob",
"middleName": "Jack",
"lastName": "TEST1",
"suffix": "MR",
"legalAddress": {
"city": "BOSTON",
"stateProvince": "MA",
"country": "US",
"postalCode": "22333",
"street": "2 Perimeter Park S"
},
"occupation": "Computers",
"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"
},
"birthDate": "1983-12-13",
"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"
}
}
}
]
}
When you pass all the validations, you get the Status = Open at the get-account endpoint for your account number and your account creation with StoneX is successful!
Response
A successful account creation with the New Account API will return a structured response with the added account details.
- Example
{
"statusCode": 200,
"message": "Request successful.",
"data": {
"message": {
"registrationType": "Individual",
"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",
"city": "BALLSTON LAKE",
"stateProvince": "AL",
"country": "US",
"postalCode": "14781"
},
"accountNumber": "10002926",
"primaryOwner": {
"sourceOfFunds": [
"Employment",
"Other"
],
"otherSourceOfFund": "OTHERTESTING",
"firstName": "JOHNN",
"middleName": "DAVIDD",
"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": {},
"phoneNumberCell": "2059871212",
"phoneNumberHome": "9992986495",
"phoneNumberBusiness": "1234567890",
"caisInformation": {
"customerType": [
"Advisor"
],
"accountType": [
"Institution",
"Retirement"
],
"role": "AUTH"
},
"trustedContact": {
"name": "JANE SMITH",
"relationship": "SPOUSE",
"phoneNumber": "2056786578",
"email": "[email protected]",
"address": {
"street": "459 SOUTH SEGUNBAGICHA",
"city": "RAMNA",
"stateProvince": "NY",
"country": "US",
"postalCode": "35243"
}
},
"affiliation": {
"political": "True",
"relationship": "CHILD",
"name": "JOHN DOE",
"organization": "EXAMPLE ORGANIZATION",
"address": {
"street": "1234 ELMWOOD CRESCENT AVENUES SPRINGFIEDS IL BOOMER",
"city": "BOSTON",
"stateProvince": "AL",
"country": "US",
"postalCode": "35243"
}
},
"maritalStatus": "Single",
"dependents": "3"
},
"associatedParties": [
{
"role": "Secondary",
"financialProfile": {
"investmentExperience": {
"stocks": "Average",
"bonds": "Extensive",
"options": "Limited",
"mutualFunds": "Extensive",
"annuities": "None"
}
},
"firstName": "ROB",
"middleName": "JACK",
"lastName": "TEST1",
"suffix": "MR",
"citizenshipCountry": "US",
"birthDate": "1983-12-13",
"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": {},
"phoneNumberCell": "2059871212",
"caisInformation": {
"customerType": [
"Advisor"
],
"accountType": [],
"role": "AUTH"
},
"maritalStatus": "Married",
"dependents": "2"
}
],
"financialProfile": {
"annualIncome": "F",
"netWorth": "B",
"liquidNetWorth": "B",
"liquidityNeed": "None",
"liquidityTime": "Medium",
"taxBracket": "TenToFifteen",
"investmentTimeHorizon": "OneToThreeYears",
"investmentProfile": "Moderate",
"investmentExperience": {
"stocks": "Limited",
"bonds": "None",
"options": "None",
"mutualFunds": "Limited",
"annuities": "Limited"
}
},
"beneficiaries": [
{
"primaryContingent": "Primary",
"name": "PRIMARY BENE 1",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2003-07-23",
"taxIdNumber": "123456770",
"relationship": "Spouse",
"percentageAllocation": "10"
},
{
"primaryContingent": "Primary",
"name": "PRIMARY BENE 2",
"address": {
"street": "123 MAIN ST",
"city": "MOUNTAIN BRK",
"stateProvince": "AL",
"country": "US",
"postalCode": "35216"
},
"birthDate": "2006-01-30",
"taxIdNumber": "123456771",
"relationship": "Other",
"percentageAllocation": "10"
}
]
}
},
"errors": [],
"traceId": "00-17c9514b2d8050b6f03784ef023101b3-1c13102b8da2af5a-01",
"hasErrors": false
}
Account Opening Submissions are Asynchronous
See more about Asynchronous Requests