--- title: "Create User" method: POST path: "/users" tags: ["Users"] --- # Create User `POST /users` Creates a User. ## Request body - UsersReq - `username` string - `password` string - `userType` 'INDIVIDUAL_TRADER' | 'CUSTODIAL' | 'BENEFICIARY', required — The type of user being onboarded. - `wlpID` string — The wlpID is a deep backoffice ID that identifies each partner from each other. *⚠️ Only require to pass if your existing partner before **10/1/22**. - `parentIBID` string — The parentIBID is a identifier that identifies a partners different business segments. *⚠️ Only require to pass if your existing partner before **10/1/22**. - `walletSettlementProfileID` string — The walletSettlementProfileID is a identifier that denotes a user's wallet settlement profile. *⚠️ This is optional and only users for certain partners are eligible. - `documents` union[], required — The personal identifiable information & digital signatures. - union - BasicInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO', required — The type of data object. - `data` object, required - `firstName` string, required — The first name of the user. - `lastName` string, required — The last (family) name of the user. - `country` string, required — The country where the User is residing. - `phone` string, required — The phone number of the user. - `emailAddress` string, required — The user's email address. - IdentificationInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO', required — The type of data object. - `data` object, required - `value` string, required — The user's national identification number or tax identification number. - `type` 'SSN' | 'EIN' | 'FTIN' | 'PASSPORT' | 'ALIEN_ID' | 'OTHER', required — The type of national identification number or tax identification number. **Note:** `FTNLO` is deprecated and should not be used for new integrations. - `citizenship` string, required — The user's country. - `issuingCountry` string — The user's country. - `issuingProvince` string — The user's current state/province/territory, where they live. - `issueDate` string - `expiryDate` string - `description` string — Additional information about the identification type provided. - TaxInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO' — The type of data object. - `data` object - `taxTreatyWithUS` boolean, required — True, if the user lives in a treaty country and is claiming tax treaty with the United States. - `usTaxpayer` boolean — True if the party is a US Tax payer - PersonalInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO', required — The type of data object. - `data` object, required - `birthDay` number, required — The User's born day. - `birthMonth` number, required — The User's born month. - `birthYear` number, required — The User's born year. - `dateOfDeath` string — The User's date of death in YYYY-MM-DD format. - `politicallyExposedNames` string, required — The names of the people whom are political exposes, separated by a comma. *⚠️ Can be set to 'NULL' if not politically exposed - `marital` 'SINGLE' | 'DIVORCED' | 'MARRIED' | 'WIDOWED' | 'PARTNER' — The marital status of the user. - AddressInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO', required — The type of data object. - `data` object, required - `street1` string, required — The user's current street address, where they live. - `street2` string — The user's additional details of an address i.e. an apartment number. - `city` string, required — The user's current city, where they live. - `province` string, required — The user's current state/province/territory, where they live. - `postalCode` string, required — The user's current postal code (zip code), where they live. - `country` string, required — The user's country. - KYCVerificationInfo - `type` string - `data` object - `verification` 'APPROVED' | 'FAILED' - `verificationIDType` 'DRIVER_LICENSE' | 'NATIONAL_ID' | 'RESIDENCE_PERMIT' | 'PASSPORT' | 'VISA' | 'TAX_ID' | 'VOTER_ID' | 'WORK_PERMIT' | 'TRUST' | 'TRUST_CORP' | 'CORPORATE' - `verificationFullName` string — The name of the customer that was passed during the KYC verification. - `verificationTimestamp` string — The ISO 8601 timestamp of when the KYC verification was completed by the partner. - `verificationTransactionID` string — A unique identifier passed to reference the KYC verification was completed by the partner. - `customField1` string - `customField2` string - `customField3` string - `customField4` string - `customField5` string - EmploymentInfo - `type` string, required - `data` object, required - `status` 'EMPLOYED' | 'RETIRED' | 'STUDENT' | 'UNEMPLOYED' | 'SELF_EMPLOYED', required — The User current employment status. - `company` string — The User's current employer name. *⚠️ Only required when status equal to EMPLOYED or SELF_EMPLOYED & type is not being provided* - `companyID` string — A unique identifier created for each Institution or entity on DriveWealth's platform.* - `from` string — The User's start date at the employment. - `to` string — The User's end date at the employment. - `type` 'AGRICULTURE' | 'MINING' | 'UTILITIES' | 'CONSTRUCTION' | 'MANUFACTURING' | 'WHOLESALE' | 'RETAIL' | 'TRANSPORT' | 'INFORMATION' | 'FINANCE' | 'REAL_ESTATE' | 'PROFESSIONAL' | 'MANAGEMENT' | 'EDUCATION' | 'HEALTH' | 'ART' | 'FOOD' | 'PUBLIC' | 'WASTE' — The User's current employer type. *⚠️ Only required when status equal to EMPLOYED or SELF_EMPLOYED & company is not being provided* - `position` 'ACCOUNTANT' | 'ACTUARY' | 'ADJUSTER' | 'ADMINISTRATOR' | 'ADVERTISER' | 'AGENT' | 'ATC' | 'AMBASSADOR' | 'ANALYST' | 'APPRAISER' | 'ARCHITECT' | 'ARTIST' | 'ASSISTANT' | 'ATHLETE' | 'ATTENDANT' | 'ATTORNEY' | 'AUCTIONEER' | 'AUDITOR' | 'BARBER' | 'BROKER' | 'BUSINESS_EXEC' | 'BUSINESS_OWNER' | 'CAREGIVER' | 'CARPENTER' | 'CASHIER' | 'CHEF' | 'CHIROPRACTOR' | 'CIVIL' | 'CLERGY' | 'CLERK' | 'COMPLIANCE' | 'CONSULTANT' | 'CONTRACTOR' | 'COUNSELOR' | 'CUSTOMER_SERVICE' | 'DEALER' | 'DEVELOPER' | 'DISTRIBUTOR' | 'DOCTOR' | 'DRIVER' | 'ENGINEER' | 'EXAMINER' | 'EXTERMINATOR' | 'FACTORY' | 'FARMER' | 'FINANCIAL' | 'FISHERMAN' | 'FLIGHT' | 'HR' | 'IMPEX' | 'INSPECTOR' | 'INTERN' | 'INVESTMENT' | 'INVESTOR' | 'IT' | 'JANITOR' | 'JEWELER' | 'LABORER' | 'LANDSCAPER' | 'LENDING' | 'MANAGER' | 'MECHANIC' | 'MILITARY' | 'MORTICIAN' | 'NURSE' | 'NUTRITIONIST' | 'OFFICE' | 'PHARMACIST' | 'PHYSICAL' | 'PILOT' | 'POLICE' | 'POLITICIAN' | 'PM' | 'REP' | 'RESEARCHER' | 'SAILOR' | 'SALES' | 'SCIENTIST' | 'SEAMSTRESS' | 'SECURITY' | 'SOCIAL' | 'TEACHER' | 'TECHNICIAN' | 'TELLER' | 'TRADESPERSON' | 'TRAINER' | 'TRANSPORTER' | 'UNDERWRITER' | 'WRITER' — The User's current role at the employment. *⚠️ Only required when status equal to EMPLOYED or SELF_EMPLOYED & using Drivewealth's Market Data Offering* - `broker` boolean, required — True, if the User's current employer is broker. - `directorOf` string, required — The company name, ticker of the company; if the user is a director or owns more than 10% of a publicly traded company. *⚠️ Can be set to 'NULL' if not applicable* - InvestorProfileInfo - `type` string, required - `data` object, required - `investmentExperience` 'NONE' | 'YRS_1_2' | 'YRS_3_5' | 'YRS_5_10' | 'YRS_10_', required — The User's current investment expertise. *⚠️ Can be defaulted to 'YRS_1_2' for all asset classes, except Options.* - `annualIncome` number, required — The User's current annalized income over one year. - `networthTotal` number, required — The user's current networth. This calculation is the User's assets - liabilities. - `riskTolerance` 'LOW' | 'MODERATE' | 'SPECULATION' | 'HIGH', required — The User's risk ceiling. *⚠️ Can be defaulted to 'LOW' for all asset classes, except Options.* - `investmentObjectives` 'LONG_TERM' | 'INFREQUENT' | 'FREQUENT' | 'ACTIVE_DAILY' | 'NEW' | 'CAPITAL_PRESERVATION' | 'GROWTH' | 'INCOME' | 'SPECULATION', required — The User's current investment objectives. *⚠️ Can be defaulted to 'CAPITAL_PRESERVATION' for all asset classes, except Options.* - `secondaryInvestmentObjectives` string[] — The User's secondary investment objectives. - `networthLiquid` number, required — The user's liquid net worth. The amount of cash or near cash equivalents of the User's net worth. *⚠️ Can be defaulted to '-1' for all asset classes, except Options.* - `dependents` number — Total number of dependents the account holder has. *⚠️ Required for Options Onboarding.* - `optionsSuitability` object — Details about the User's suitability for trading options, including their experience with options and equities. *⚠️ Required for Options Onboarding.* - `equitiesExperience` InvestmentSuitability - … - `optionsExperience` InvestmentSuitability - … - `equitiesExperience` InvestmentSuitabilityEquities - `knowledge` 'LIMITED' | 'NONE' | 'GOOD' | 'EXCELLENT' — Trading experience level. - `yearsOfExperience` number — Number of years of trading experience. - `tradesPerYear` number — Total number of trades per year. - `averageTradeValue` number — Average USD value per trade. - `transactionTypes` string[] — The types of transactions the user has experience with. - `optionsExperience` InvestmentSuitabilityOptions - `knowledge` 'LIMITED' | 'NONE' | 'GOOD' | 'EXCELLENT' — Trading experience level. - `yearsOfExperience` number — Number of years of trading experience. - `tradesPerYear` number — Total number of trades per year. - `averageTradeValue` number — Average USD value per trade. - `transactionTypes` string[] — The types of transactions the user has experience with. - `fixedIncomeExperience` union - object - … - object - … - `commodityExperience` union - object - … - object - … - `otherFinancialExperience` union - object - … - object - … - Disclosures - `type` string, required - `data` object, required - `extendedHoursAgreement` boolean — True, if the User accepts DriveWealth's Extended Hours Agreement. - `termsOfUse` boolean, required — True, if the User accepts DriveWealth's Terms of Use. - `customerAgreement` boolean, required — True, if the User accepts DriveWealth's Customer Agreement. - `iraAgreement` boolean — True, if the User accepts DriveWealth's Individual Retirement Account (IRA) Agreement. *⚠ Only for opening IRA accounts.* - `marketDataAgreement` boolean, required — True, if the User accepts DriveWealth's Market Data Agreement. - `optionsAgreement` boolean — True, if the User accepts DriveWealth's Options trading Agreement. - `oddLinkAgreement` boolean — True, if the User accepts DriveWealth's ODD Link Agreement. - `rule14b` boolean, required — True, if the User accepts DriveWealth's Rule 14b1(c). - `privacyPolicy` boolean, required — True, if the User accepts DriveWealth's Privacy Policy. - `dataSharing` boolean, required — True, if the User accepts DriveWealth's Data Sharing Policy. - `signedBy` string, required — The User's digital signature (full name). - MarginDisclosure - `type` string - `data` object - `marginAgreement` boolean, required — A User's acceptance of DriveWealth's Margin Agreement. - FPSLDisclosure - `type` string - `data` object - `fpslAgreement` boolean, required — A User's acceptance of DriveWealth's Fully Paid Securities Lending (FPSL) Agreement. - CustodianInfo - `type` string - `data` object - `userID` string — A unique identifier created for each User on DriveWealth's platform. - DirectorInfo - `type` string - `data` object - `directorList` Directors[] - `title` string — The title of the director. - `controlContact` boolean — True, if the director has control over the account. - `institutionalID` string — The unique identifier of the institution director should assioacted with.. - `roles` string[] - `percentage` number — The percentage of ownership the director has in the institution. Value must be greater than 0 and up to 1 (representing 0-100%), with a maximum of 2 decimal places. - InstitutionalInfo - `type` string - `data` object - `physicalAddressLine1` string — The physical street address where the institution is located. - `physicalAddressLine2` string - `physicalCity` string — The institutuion physical city. - `physicalStateProvince` string — The institutuion physical state or province. - `physicalZipPostalCode` string — The institutuion physical postal or zip code. - `physicalCountryID` string — The institutuion physical country of origin. - `companyOrganizedAs` 'NON_CORP' | 'INC' | 'CLUB' | 'LLC' | 'LLLP' | 'LLP' | 'LP' | 'PARTNERSHIP' | 'SOLE_PROPRIETOR' — The institutuion orginizational structure. - `usaBranch` boolean — True, if the institutuion is registered in side of the United States. - `foreignBank` boolean — True, if the institution is a foreign bank. - `foreignFinancialInstitution` boolean — True, if the institution is maintained for a foreign finanical institution. - `directorCount` number — The number of directors to be added to institutional account. - TrustInfo - `type` string - `data` object - `name` string — The name of the trust. - `dateEstablished` string — The inception date of the trust. - `stateEstablished` string — The state or province where the trust was established. - `street1` string — The physical street address where the institution is located. - `street2` string - `city` string — The institutuion physical city. - `province` string — The institutuion physical state or province. - `postalCode` string — The institutuion physical postal or zip code. - `primaryTrusteeAuthority` 'TRUSTEE_ONLY' | 'TRUSTEE_AND_GRANTOR' | 'MODIFY_TRUSTEES' | 'MODIFY_TRUST' — The permissions the primary trustee has over the trust. - `tin` string — The tax identification number of the trust. - `metadata` object — The metadata object allows for creating a maximum of 5 keys (max 36 characters) and each value cannot exceed more than 128 bytes. ## Response `200` Creating a User was Successful. - UserResponse - `id` string — A unique identifier created for each User on DriveWealth's platform. - `userType` object - `name` 'INDIVIDUAL_TRADER' | 'CUSTODIAL' | 'BENEFICIARY' — The type of user being onboarded. - `description` string — A custom description of the User type. - `status` object - `name` 'PENDING' | 'APPROVED' — The user's current status. - `description` string — A custom description of the User's status. - `parentIBID` object - `id` string — The unique identifier of the firm. - `name` string — The firm name. - `documents` union[] — The personal identifiable information & digital signatures. - union - BasicInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO', required — The type of data object. - `data` object, required - `firstName` string, required — The first name of the user. - `lastName` string, required — The last (family) name of the user. - `country` string, required — The country where the User is residing. - `phone` string, required — The phone number of the user. - `emailAddress` string, required — The user's email address. - DirectorInfo - `type` string - `data` object - `directorList` Directors[] - `title` string — The title of the director. - `controlContact` boolean — True, if the director has control over the account. - `institutionalID` string — The unique identifier of the institution director should assioacted with.. - `roles` string[] - `percentage` number — The percentage of ownership the director has in the institution. Value must be greater than 0 and up to 1 (representing 0-100%), with a maximum of 2 decimal places. - IdentificationInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO', required — The type of data object. - `data` object, required - `value` string, required — The user's national identification number or tax identification number. - `type` 'SSN' | 'EIN' | 'FTIN' | 'PASSPORT' | 'ALIEN_ID' | 'OTHER', required — The type of national identification number or tax identification number. **Note:** `FTNLO` is deprecated and should not be used for new integrations. - `citizenship` string, required — The user's country. - `issuingCountry` string — The user's country. - `issuingProvince` string — The user's current state/province/territory, where they live. - `issueDate` string - `expiryDate` string - `description` string — Additional information about the identification type provided. - TaxInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO' — The type of data object. - `data` object - `taxTreatyWithUS` boolean, required — True, if the user lives in a treaty country and is claiming tax treaty with the United States. - `usTaxpayer` boolean — True if the party is a US Tax payer - PersonalInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO', required — The type of data object. - `data` object, required - `birthDay` number, required — The User's born day. - `birthMonth` number, required — The User's born month. - `birthYear` number, required — The User's born year. - `dateOfDeath` string — The User's date of death in YYYY-MM-DD format. - `politicallyExposedNames` string, required — The names of the people whom are political exposes, separated by a comma. *⚠️ Can be set to 'NULL' if not politically exposed - `marital` 'SINGLE' | 'DIVORCED' | 'MARRIED' | 'WIDOWED' | 'PARTNER' — The marital status of the user. - AddressInfo - `type` 'BASIC_INFO' | 'IDENTIFICATION_INFO' | 'TAX_INFO' | 'PERSONAL_INFO' | 'ADDRESS_INFO' | 'EMPLOYMENT_INFO' | 'INVESTOR_PROFILE_INFO' | 'DISCLOSURES' | 'MARGIN_DISCLOSURE' | 'FPSL_DISCLOSURE' | 'CUSTODIAN_INFO' | 'DIRECTOR_INFO' | 'INSTITUTIONAL_INFO' | 'TRUST_INFO', required — The type of data object. - `data` object, required - `street1` string, required — The user's current street address, where they live. - `street2` string — The user's additional details of an address i.e. an apartment number. - `city` string, required — The user's current city, where they live. - `province` string, required — The user's current state/province/territory, where they live. - `postalCode` string, required — The user's current postal code (zip code), where they live. - `country` string, required — The user's country. - EmploymentInfo - `type` string, required - `data` object, required - `status` 'EMPLOYED' | 'RETIRED' | 'STUDENT' | 'UNEMPLOYED' | 'SELF_EMPLOYED', required — The User current employment status. - `company` string — The User's current employer name. *⚠️ Only required when status equal to EMPLOYED or SELF_EMPLOYED & type is not being provided* - `companyID` string — A unique identifier created for each Institution or entity on DriveWealth's platform.* - `from` string — The User's start date at the employment. - `to` string — The User's end date at the employment. - `type` 'AGRICULTURE' | 'MINING' | 'UTILITIES' | 'CONSTRUCTION' | 'MANUFACTURING' | 'WHOLESALE' | 'RETAIL' | 'TRANSPORT' | 'INFORMATION' | 'FINANCE' | 'REAL_ESTATE' | 'PROFESSIONAL' | 'MANAGEMENT' | 'EDUCATION' | 'HEALTH' | 'ART' | 'FOOD' | 'PUBLIC' | 'WASTE' — The User's current employer type. *⚠️ Only required when status equal to EMPLOYED or SELF_EMPLOYED & company is not being provided* - `position` 'ACCOUNTANT' | 'ACTUARY' | 'ADJUSTER' | 'ADMINISTRATOR' | 'ADVERTISER' | 'AGENT' | 'ATC' | 'AMBASSADOR' | 'ANALYST' | 'APPRAISER' | 'ARCHITECT' | 'ARTIST' | 'ASSISTANT' | 'ATHLETE' | 'ATTENDANT' | 'ATTORNEY' | 'AUCTIONEER' | 'AUDITOR' | 'BARBER' | 'BROKER' | 'BUSINESS_EXEC' | 'BUSINESS_OWNER' | 'CAREGIVER' | 'CARPENTER' | 'CASHIER' | 'CHEF' | 'CHIROPRACTOR' | 'CIVIL' | 'CLERGY' | 'CLERK' | 'COMPLIANCE' | 'CONSULTANT' | 'CONTRACTOR' | 'COUNSELOR' | 'CUSTOMER_SERVICE' | 'DEALER' | 'DEVELOPER' | 'DISTRIBUTOR' | 'DOCTOR' | 'DRIVER' | 'ENGINEER' | 'EXAMINER' | 'EXTERMINATOR' | 'FACTORY' | 'FARMER' | 'FINANCIAL' | 'FISHERMAN' | 'FLIGHT' | 'HR' | 'IMPEX' | 'INSPECTOR' | 'INTERN' | 'INVESTMENT' | 'INVESTOR' | 'IT' | 'JANITOR' | 'JEWELER' | 'LABORER' | 'LANDSCAPER' | 'LENDING' | 'MANAGER' | 'MECHANIC' | 'MILITARY' | 'MORTICIAN' | 'NURSE' | 'NUTRITIONIST' | 'OFFICE' | 'PHARMACIST' | 'PHYSICAL' | 'PILOT' | 'POLICE' | 'POLITICIAN' | 'PM' | 'REP' | 'RESEARCHER' | 'SAILOR' | 'SALES' | 'SCIENTIST' | 'SEAMSTRESS' | 'SECURITY' | 'SOCIAL' | 'TEACHER' | 'TECHNICIAN' | 'TELLER' | 'TRADESPERSON' | 'TRAINER' | 'TRANSPORTER' | 'UNDERWRITER' | 'WRITER' — The User's current role at the employment. *⚠️ Only required when status equal to EMPLOYED or SELF_EMPLOYED & using Drivewealth's Market Data Offering* - `broker` boolean, required — True, if the User's current employer is broker. - `directorOf` string, required — The company name, ticker of the company; if the user is a director or owns more than 10% of a publicly traded company. *⚠️ Can be set to 'NULL' if not applicable* - InvestorProfileInfo - `type` string, required - `data` object, required - `investmentExperience` 'NONE' | 'YRS_1_2' | 'YRS_3_5' | 'YRS_5_10' | 'YRS_10_', required — The User's current investment expertise. *⚠️ Can be defaulted to 'YRS_1_2' for all asset classes, except Options.* - `annualIncome` number, required — The User's current annalized income over one year. - `networthTotal` number, required — The user's current networth. This calculation is the User's assets - liabilities. - `riskTolerance` 'LOW' | 'MODERATE' | 'SPECULATION' | 'HIGH', required — The User's risk ceiling. *⚠️ Can be defaulted to 'LOW' for all asset classes, except Options.* - `investmentObjectives` 'LONG_TERM' | 'INFREQUENT' | 'FREQUENT' | 'ACTIVE_DAILY' | 'NEW' | 'CAPITAL_PRESERVATION' | 'GROWTH' | 'INCOME' | 'SPECULATION', required — The User's current investment objectives. *⚠️ Can be defaulted to 'CAPITAL_PRESERVATION' for all asset classes, except Options.* - `secondaryInvestmentObjectives` string[] — The User's secondary investment objectives. - `networthLiquid` number, required — The user's liquid net worth. The amount of cash or near cash equivalents of the User's net worth. *⚠️ Can be defaulted to '-1' for all asset classes, except Options.* - `dependents` number — Total number of dependents the account holder has. *⚠️ Required for Options Onboarding.* - `optionsSuitability` object — Details about the User's suitability for trading options, including their experience with options and equities. *⚠️ Required for Options Onboarding.* - `equitiesExperience` InvestmentSuitability - … - `optionsExperience` InvestmentSuitability - … - `equitiesExperience` InvestmentSuitabilityEquities - `knowledge` 'LIMITED' | 'NONE' | 'GOOD' | 'EXCELLENT' — Trading experience level. - `yearsOfExperience` number — Number of years of trading experience. - `tradesPerYear` number — Total number of trades per year. - `averageTradeValue` number — Average USD value per trade. - `transactionTypes` string[] — The types of transactions the user has experience with. - `optionsExperience` InvestmentSuitabilityOptions - `knowledge` 'LIMITED' | 'NONE' | 'GOOD' | 'EXCELLENT' — Trading experience level. - `yearsOfExperience` number — Number of years of trading experience. - `tradesPerYear` number — Total number of trades per year. - `averageTradeValue` number — Average USD value per trade. - `transactionTypes` string[] — The types of transactions the user has experience with. - `fixedIncomeExperience` union - object - … - object - … - `commodityExperience` union - object - … - object - … - `otherFinancialExperience` union - object - … - object - … - Disclosures - `type` string, required - `data` object, required - `extendedHoursAgreement` boolean — True, if the User accepts DriveWealth's Extended Hours Agreement. - `termsOfUse` boolean, required — True, if the User accepts DriveWealth's Terms of Use. - `customerAgreement` boolean, required — True, if the User accepts DriveWealth's Customer Agreement. - `iraAgreement` boolean — True, if the User accepts DriveWealth's Individual Retirement Account (IRA) Agreement. *⚠ Only for opening IRA accounts.* - `marketDataAgreement` boolean, required — True, if the User accepts DriveWealth's Market Data Agreement. - `optionsAgreement` boolean — True, if the User accepts DriveWealth's Options trading Agreement. - `oddLinkAgreement` boolean — True, if the User accepts DriveWealth's ODD Link Agreement. - `rule14b` boolean, required — True, if the User accepts DriveWealth's Rule 14b1(c). - `privacyPolicy` boolean, required — True, if the User accepts DriveWealth's Privacy Policy. - `dataSharing` boolean, required — True, if the User accepts DriveWealth's Data Sharing Policy. - `signedBy` string, required — The User's digital signature (full name). - `wlpID` string — The wlpID is a deep backoffice ID that identifies each partner from each other. - `walletSettlementProfileID` string — The walletSettlementProfileID is a identifier that denotes a user's wallet settlement profile for eligible partners. - `referralCode` string — The associated referral program associated to the User. - `createdWhen` string — The createdWhen is the date and time the User was created. - `updatedWhen` string — The updatedWhen is the last date and time the User was updated. ## Other responses - `400` — Bad Request - validation error in the request payload. --- [API](https://skmtc.net/drivewealth/apis/authentication-apis.md) · [All operations](https://skmtc.net/drivewealth/apis/authentication-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/drivewealth/authentication-apis/versions/9fced6d0ac41/schema)